Chilkat Online Tools

VB.NET / Zoom API / Get locked settings

Back to Collection Items

' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim http As New Chilkat.Http
Dim success As Boolean

Dim queryParams As New Chilkat.JsonObject
queryParams.UpdateString("option","quis officia in reprehenderit")
queryParams.UpdateString("custom_query_fields","quis officia in reprehenderit")

' Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = "<access_token>"


Dim resp As Chilkat.HttpResponse = http.QuickRequestParams("GET","https://api.zoom.us/v2/accounts/:accountId/lock_settings",queryParams)
If (http.LastMethodSuccess = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If


Dim sbResponseBody As New Chilkat.StringBuilder
resp.GetBodySb(sbResponseBody)

Dim jResp As New Chilkat.JsonObject
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Debug.WriteLine("Response Body:")
Debug.WriteLine(jResp.Emit())

Dim respStatusCode As Integer = resp.StatusCode
Debug.WriteLine("Response Status Code = " & respStatusCode)
If (respStatusCode >= 400) Then
    Debug.WriteLine("Response Header:")
    Debug.WriteLine(resp.Header)
    Debug.WriteLine("Failed.")

    Exit Sub
End If



' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)

' {
'   "schedule_meeting": {
'     "host_video": true,
'     "participant_video": true,
'     "audio_type": true,
'     "join_before_host": false,
'     "enforce_login": false,
'     "enforce_login_with_domains": false,
'     "enforce_login_domains": "ut Excepteur aute",
'     "not_store_meeting_topic": false,
'     "require_password_for_scheduling_new_meetings": true,
'     "require_password_for_instant_meetings": false,
'     "require_password_for_pmi_meetings": false,
'     "use_pmi_for_scheduled_meetings": true,
'     "use_pmi_for_instant_meetings": false,
'     "meeting_authentication": false,
'     "embed_password_in_join_link": false
'   },
'   "in_meeting": {
'     "e2e_encryption": true,
'     "chat": true,
'     "private_chat": false,
'     "auto_saving_chat": false,
'     "entry_exit_chime": "in ut",
'     "feedback": true,
'     "post_meeting_feedback": true,
'     "co_host": true,
'     "polling": true,
'     "attendee_on_hold": false,
'     "show_meeting_control_toolbar": true,
'     "allow_show_zoom_windows": false,
'     "annotation": true,
'     "whiteboard": false,
'     "remote_control": false,
'     "webinar_question_answer": true,
'     "anonymous_question_answer": true,
'     "breakout_room": false,
'     "closed_caption": false,
'     "far_end_camera_control": false,
'     "group_hd": true,
'     "virtual_background": false,
'     "alert_guest_join": true,
'     "auto_answer": true,
'     "sending_default_email_invites": true,
'     "use_html_format_email": false,
'     "dscp_marking": true,
'     "stereo_audio": false,
'     "original_audio": false,
'     "screen_sharing": true,
'     "custom_data_center_regions": true,
'     "meeting_reactions": false,
'     "file_transfer": false,
'     "request_permission_to_unmute": false,
'     "allow_live_streaming": true,
'     "attention_mode_focus_mode": false,
'     "webinar_live_streaming": false,
'     "webinar_chat": true,
'     "save_caption": false,
'     "slide_control": true,
'     "meeting_survey": false,
'     "webinar_polling": true,
'     "webinar_survey": false
'   },
'   "email_notification": {
'     "cloud_recording_available_reminder": true,
'     "jbh_reminder": false,
'     "cancel_meeting_reminder": false,
'     "alternative_host_reminder": true,
'     "schedule_for_reminder": true
'   },
'   "recording": {
'     "local_recording": false,
'     "cloud_recording": false,
'     "auto_recording": "est moll",
'     "cloud_recording_download": false,
'     "account_user_access_recording": false,
'     "host_delete_cloud_recording": true,
'     "auto_delete_cmr": true,
'     "recording_authentication": "ut ipsum labore pari",
'     "prevent_host_access_recording": true,
'     "ip_address_access_control": {
'       "enable": true,
'       "ip_addresses_or_ranges": "ea"
'     }
'   },
'   "telephony": {
'     "third_party_audio": true,
'     "telephony_regions": true
'   },
'   "tsp": {
'     "call_out": false,
'     "show_international_numbers_link": true
'   },
'   "other_options": {
'     "blur_snapshot": true
'   },
'   "audio_conferencing": {
'     "toll_free_and_fee_based_toll_call": false
'   }
' }

' Sample code for parsing the JSON response...
' Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code




Dim Host_video As Boolean = jResp.BoolOf("schedule_meeting.host_video")
Dim Participant_video As Boolean = jResp.BoolOf("schedule_meeting.participant_video")
Dim Audio_type As Boolean = jResp.BoolOf("schedule_meeting.audio_type")
Dim Join_before_host As Boolean = jResp.BoolOf("schedule_meeting.join_before_host")
Dim Enforce_login As Boolean = jResp.BoolOf("schedule_meeting.enforce_login")
Dim Enforce_login_with_domains As Boolean = jResp.BoolOf("schedule_meeting.enforce_login_with_domains")
Dim Enforce_login_domains As String = jResp.StringOf("schedule_meeting.enforce_login_domains")
Dim Not_store_meeting_topic As Boolean = jResp.BoolOf("schedule_meeting.not_store_meeting_topic")
Dim Require_password_for_scheduling_new_meetings As Boolean = jResp.BoolOf("schedule_meeting.require_password_for_scheduling_new_meetings")
Dim Require_password_for_instant_meetings As Boolean = jResp.BoolOf("schedule_meeting.require_password_for_instant_meetings")
Dim Require_password_for_pmi_meetings As Boolean = jResp.BoolOf("schedule_meeting.require_password_for_pmi_meetings")
Dim Use_pmi_for_scheduled_meetings As Boolean = jResp.BoolOf("schedule_meeting.use_pmi_for_scheduled_meetings")
Dim Use_pmi_for_instant_meetings As Boolean = jResp.BoolOf("schedule_meeting.use_pmi_for_instant_meetings")
Dim Meeting_authentication As Boolean = jResp.BoolOf("schedule_meeting.meeting_authentication")
Dim Embed_password_in_join_link As Boolean = jResp.BoolOf("schedule_meeting.embed_password_in_join_link")
Dim E2e_encryption As Boolean = jResp.BoolOf("in_meeting.e2e_encryption")
Dim Chat As Boolean = jResp.BoolOf("in_meeting.chat")
Dim Private_chat As Boolean = jResp.BoolOf("in_meeting.private_chat")
Dim Auto_saving_chat As Boolean = jResp.BoolOf("in_meeting.auto_saving_chat")
Dim Entry_exit_chime As String = jResp.StringOf("in_meeting.entry_exit_chime")
Dim Feedback As Boolean = jResp.BoolOf("in_meeting.feedback")
Dim Post_meeting_feedback As Boolean = jResp.BoolOf("in_meeting.post_meeting_feedback")
Dim Co_host As Boolean = jResp.BoolOf("in_meeting.co_host")
Dim Polling As Boolean = jResp.BoolOf("in_meeting.polling")
Dim Attendee_on_hold As Boolean = jResp.BoolOf("in_meeting.attendee_on_hold")
Dim Show_meeting_control_toolbar As Boolean = jResp.BoolOf("in_meeting.show_meeting_control_toolbar")
Dim Allow_show_zoom_windows As Boolean = jResp.BoolOf("in_meeting.allow_show_zoom_windows")
Dim Annotation As Boolean = jResp.BoolOf("in_meeting.annotation")
Dim Whiteboard As Boolean = jResp.BoolOf("in_meeting.whiteboard")
Dim Remote_control As Boolean = jResp.BoolOf("in_meeting.remote_control")
Dim Webinar_question_answer As Boolean = jResp.BoolOf("in_meeting.webinar_question_answer")
Dim Anonymous_question_answer As Boolean = jResp.BoolOf("in_meeting.anonymous_question_answer")
Dim Breakout_room As Boolean = jResp.BoolOf("in_meeting.breakout_room")
Dim Closed_caption As Boolean = jResp.BoolOf("in_meeting.closed_caption")
Dim Far_end_camera_control As Boolean = jResp.BoolOf("in_meeting.far_end_camera_control")
Dim Group_hd As Boolean = jResp.BoolOf("in_meeting.group_hd")
Dim Virtual_background As Boolean = jResp.BoolOf("in_meeting.virtual_background")
Dim Alert_guest_join As Boolean = jResp.BoolOf("in_meeting.alert_guest_join")
Dim Auto_answer As Boolean = jResp.BoolOf("in_meeting.auto_answer")
Dim Sending_default_email_invites As Boolean = jResp.BoolOf("in_meeting.sending_default_email_invites")
Dim Use_html_format_email As Boolean = jResp.BoolOf("in_meeting.use_html_format_email")
Dim Dscp_marking As Boolean = jResp.BoolOf("in_meeting.dscp_marking")
Dim Stereo_audio As Boolean = jResp.BoolOf("in_meeting.stereo_audio")
Dim Original_audio As Boolean = jResp.BoolOf("in_meeting.original_audio")
Dim Screen_sharing As Boolean = jResp.BoolOf("in_meeting.screen_sharing")
Dim Custom_data_center_regions As Boolean = jResp.BoolOf("in_meeting.custom_data_center_regions")
Dim Meeting_reactions As Boolean = jResp.BoolOf("in_meeting.meeting_reactions")
Dim File_transfer As Boolean = jResp.BoolOf("in_meeting.file_transfer")
Dim Request_permission_to_unmute As Boolean = jResp.BoolOf("in_meeting.request_permission_to_unmute")
Dim Allow_live_streaming As Boolean = jResp.BoolOf("in_meeting.allow_live_streaming")
Dim Attention_mode_focus_mode As Boolean = jResp.BoolOf("in_meeting.attention_mode_focus_mode")
Dim Webinar_live_streaming As Boolean = jResp.BoolOf("in_meeting.webinar_live_streaming")
Dim Webinar_chat As Boolean = jResp.BoolOf("in_meeting.webinar_chat")
Dim Save_caption As Boolean = jResp.BoolOf("in_meeting.save_caption")
Dim Slide_control As Boolean = jResp.BoolOf("in_meeting.slide_control")
Dim Meeting_survey As Boolean = jResp.BoolOf("in_meeting.meeting_survey")
Dim Webinar_polling As Boolean = jResp.BoolOf("in_meeting.webinar_polling")
Dim Webinar_survey As Boolean = jResp.BoolOf("in_meeting.webinar_survey")
Dim Cloud_recording_available_reminder As Boolean = jResp.BoolOf("email_notification.cloud_recording_available_reminder")
Dim Jbh_reminder As Boolean = jResp.BoolOf("email_notification.jbh_reminder")
Dim Cancel_meeting_reminder As Boolean = jResp.BoolOf("email_notification.cancel_meeting_reminder")
Dim Alternative_host_reminder As Boolean = jResp.BoolOf("email_notification.alternative_host_reminder")
Dim Schedule_for_reminder As Boolean = jResp.BoolOf("email_notification.schedule_for_reminder")
Dim Local_recording As Boolean = jResp.BoolOf("recording.local_recording")
Dim Cloud_recording As Boolean = jResp.BoolOf("recording.cloud_recording")
Dim Auto_recording As String = jResp.StringOf("recording.auto_recording")
Dim Cloud_recording_download As Boolean = jResp.BoolOf("recording.cloud_recording_download")
Dim Account_user_access_recording As Boolean = jResp.BoolOf("recording.account_user_access_recording")
Dim Host_delete_cloud_recording As Boolean = jResp.BoolOf("recording.host_delete_cloud_recording")
Dim Auto_delete_cmr As Boolean = jResp.BoolOf("recording.auto_delete_cmr")
Dim Recording_authentication As String = jResp.StringOf("recording.recording_authentication")
Dim Prevent_host_access_recording As Boolean = jResp.BoolOf("recording.prevent_host_access_recording")
Dim Enable As Boolean = jResp.BoolOf("recording.ip_address_access_control.enable")
Dim Ip_addresses_or_ranges As String = jResp.StringOf("recording.ip_address_access_control.ip_addresses_or_ranges")
Dim Third_party_audio As Boolean = jResp.BoolOf("telephony.third_party_audio")
Dim Telephony_regions As Boolean = jResp.BoolOf("telephony.telephony_regions")
Dim Call_out As Boolean = jResp.BoolOf("tsp.call_out")
Dim Show_international_numbers_link As Boolean = jResp.BoolOf("tsp.show_international_numbers_link")
Dim Blur_snapshot As Boolean = jResp.BoolOf("other_options.blur_snapshot")
Dim Toll_free_and_fee_based_toll_call As Boolean = jResp.BoolOf("audio_conferencing.toll_free_and_fee_based_toll_call")

Curl Command

curl -G -d "option=quis%20officia%20in%20reprehenderit"
	-d "custom_query_fields=quis%20officia%20in%20reprehenderit"
	-H "Authorization: Bearer <access_token>"
https://api.zoom.us/v2/accounts/:accountId/lock_settings

Postman Collection Item JSON

{
  "name": "Get locked settings",
  "request": {
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "{{baseUrl}}/accounts/:accountId/lock_settings?option=quis officia in reprehenderit&custom_query_fields=quis officia in reprehenderit",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "accounts",
        ":accountId",
        "lock_settings"
      ],
      "query": [
        {
          "key": "option",
          "value": "quis officia in reprehenderit",
          "description": "Optional query parameters: \n* `meeting_security` — Use this query parameter to view the meeting security settings applied to the user's account."
        },
        {
          "key": "custom_query_fields",
          "value": "quis officia in reprehenderit",
          "description": "Provide the name of the field by which you would like to filter the response. For example, if you provide \"host_video\" as the value of this field, you will get a response similar to the following:<br>\n{\n    \"schedule_meeting\": {\n        \"host_video\": false\n    }\n}\n<br>You can provide multiple values by separating them with commas(example: \"host_video,participant_video”)."
        }
      ],
      "variable": [
        {
          "key": "accountId",
          "value": "quis officia in reprehenderit",
          "description": "(Required) Unique Identifier of the account. To retrieve locked settings of the master account or a regular account, provide \"me\" as the value of this field. <br> To retrieve locked settings of a sub account, provide the Account ID of the sub account in this field."
        }
      ]
    },
    "description": "[Account Locked Settings](https://support.zoom.us/hc/en-us/articles/115005269866) allow you turn settings on or off for all users in your account. No user except the account admin or account owner can change these settings. With lock settings, you force the settings on for all users.\nUse this API to retrieve an account's locked settings. \n\n**Note:** This API can be used by Zoom Accounts that are on a Pro or a higher plan as well accounts that have master and sub accounts options enabled. <br><br>\n**Prerequisites:**\n* Pro or a higher paid account. <br>\n\n**Scope**: `account:read:admin`.\n<br> **[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`<br>\n\n\n\n\n\n**Scope:** account:read:admin"
  },
  "response": [
    {
      "name": "**Error Code:** `200`<br>\nOnly available for paid account:$accountId.\n\n**HTTP Status Code:** `200`<br>\nLocked settings for the Account returned.\n\n",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/accounts/:accountId/lock_settings?option=quis officia in reprehenderit&custom_query_fields=quis officia in reprehenderit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "accounts",
            ":accountId",
            "lock_settings"
          ],
          "query": [
            {
              "key": "option",
              "value": "quis officia in reprehenderit"
            },
            {
              "key": "custom_query_fields",
              "value": "quis officia in reprehenderit"
            }
          ],
          "variable": [
            {
              "key": "accountId",
              "value": "quis officia in reprehenderit",
              "description": "(Required) Unique Identifier of the account. To retrieve locked settings of the master account or a regular account, provide \"me\" as the value of this field. <br> To retrieve locked settings of a sub account, provide the Account ID of the sub account in this field."
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"schedule_meeting\": {\n  \"host_video\": true,\n  \"participant_video\": true,\n  \"audio_type\": true,\n  \"join_before_host\": false,\n  \"enforce_login\": false,\n  \"enforce_login_with_domains\": false,\n  \"enforce_login_domains\": \"ut Excepteur aute\",\n  \"not_store_meeting_topic\": false,\n  \"require_password_for_scheduling_new_meetings\": true,\n  \"require_password_for_instant_meetings\": false,\n  \"require_password_for_pmi_meetings\": false,\n  \"use_pmi_for_scheduled_meetings\": true,\n  \"use_pmi_for_instant_meetings\": false,\n  \"meeting_authentication\": false,\n  \"embed_password_in_join_link\": false\n },\n \"in_meeting\": {\n  \"e2e_encryption\": true,\n  \"chat\": true,\n  \"private_chat\": false,\n  \"auto_saving_chat\": false,\n  \"entry_exit_chime\": \"in ut\",\n  \"feedback\": true,\n  \"post_meeting_feedback\": true,\n  \"co_host\": true,\n  \"polling\": true,\n  \"attendee_on_hold\": false,\n  \"show_meeting_control_toolbar\": true,\n  \"allow_show_zoom_windows\": false,\n  \"annotation\": true,\n  \"whiteboard\": false,\n  \"remote_control\": false,\n  \"webinar_question_answer\": true,\n  \"anonymous_question_answer\": true,\n  \"breakout_room\": false,\n  \"closed_caption\": false,\n  \"far_end_camera_control\": false,\n  \"group_hd\": true,\n  \"virtual_background\": false,\n  \"alert_guest_join\": true,\n  \"auto_answer\": true,\n  \"sending_default_email_invites\": true,\n  \"use_html_format_email\": false,\n  \"dscp_marking\": true,\n  \"stereo_audio\": false,\n  \"original_audio\": false,\n  \"screen_sharing\": true,\n  \"custom_data_center_regions\": true,\n  \"meeting_reactions\": false,\n  \"file_transfer\": false,\n  \"request_permission_to_unmute\": false,\n  \"allow_live_streaming\": true,\n  \"attention_mode_focus_mode\": false,\n  \"webinar_live_streaming\": false,\n  \"webinar_chat\": true,\n  \"save_caption\": false,\n  \"slide_control\": true,\n  \"meeting_survey\": false,\n  \"webinar_polling\": true,\n  \"webinar_survey\": false\n },\n \"email_notification\": {\n  \"cloud_recording_available_reminder\": true,\n  \"jbh_reminder\": false,\n  \"cancel_meeting_reminder\": false,\n  \"alternative_host_reminder\": true,\n  \"schedule_for_reminder\": true\n },\n \"recording\": {\n  \"local_recording\": false,\n  \"cloud_recording\": false,\n  \"auto_recording\": \"est moll\",\n  \"cloud_recording_download\": false,\n  \"account_user_access_recording\": false,\n  \"host_delete_cloud_recording\": true,\n  \"auto_delete_cmr\": true,\n  \"recording_authentication\": \"ut ipsum labore pari\",\n  \"prevent_host_access_recording\": true,\n  \"ip_address_access_control\": {\n   \"enable\": true,\n   \"ip_addresses_or_ranges\": \"ea\"\n  }\n },\n \"telephony\": {\n  \"third_party_audio\": true,\n  \"telephony_regions\": true\n },\n \"tsp\": {\n  \"call_out\": false,\n  \"show_international_numbers_link\": true\n },\n \"other_options\": {\n  \"blur_snapshot\": true\n },\n \"audio_conferencing\": {\n  \"toll_free_and_fee_based_toll_call\": false\n }\n}"
    },
    {
      "name": "**HTTP Status Code:** `400`<br>\n**Error Code:** `2001`<br>\nAccount does not exist: $subAccountId.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/accounts/:accountId/lock_settings?option=quis officia in reprehenderit&custom_query_fields=quis officia in reprehenderit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "accounts",
            ":accountId",
            "lock_settings"
          ],
          "query": [
            {
              "key": "option",
              "value": "quis officia in reprehenderit"
            },
            {
              "key": "custom_query_fields",
              "value": "quis officia in reprehenderit"
            }
          ],
          "variable": [
            {
              "key": "accountId",
              "value": "quis officia in reprehenderit",
              "description": "(Required) Unique Identifier of the account. To retrieve locked settings of the master account or a regular account, provide \"me\" as the value of this field. <br> To retrieve locked settings of a sub account, provide the Account ID of the sub account in this field."
            }
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    }
  ]
}