本頁面由 Cloud Translation API 翻譯而成。

正在建立第三方會議

每項會議解決方案您在指令碼專案中定義的資訊清單具有關聯的 onCreateFunction。外掛程式會呼叫這個函式則每次使用者嘗試選取會議解決方案時，活動。

您必須實作外掛程式資訊清單中所述的每個 onCreateFunction。一般來說，這些函式必須執行以下操作：

擷取任何 Google 日曆活動資訊，例如活動 ID 或以及第三方會議系統建立會議。
連線至第三方會議服務並建立新會議使用 Google 日曆活動資訊。
如果因為某些原因導致會議建立要求失敗，請使用這則錯誤訊息建構並傳回 ConferenceData敬上內含 ConferenceError。如果沒有，請完成後續步驟。
1. 初始化會議的同步處理功能。
2. 將第三方會議服務傳回的資訊用於以下目的：建構並傳回新的 ConferenceData敬上物件。

擷取活動資訊

如要建立第三方會議，以便建立第三方會議的相應資訊，必須選取 Google 日曆活動。所需的確切活動資訊各不相同但通常這也包含活動開始時間、結束時間、摘要、參與者清單和 ID。

呼叫時，您定義的每個 onCreateFunction 都會傳遞引數包含日曆和活動 ID。您可以使用這些 ID 來擷取查看完整的事件資訊 Google 日曆進階服務。

Google 日曆可以在活動日期之前將會議詳細資料加入活動存在。在這種情況下，Google 日曆會將有效的 onCreateFunction 傳遞給 eventId，但之後呼叫 Calendar.Events.get() 時，錯誤回應，指出活動不存在。在這種情況下使用預留位置資料建立第三方會議；這些資料會替換下次活動時同步處理。

正在建立第三方會議

onCreateFunction 擷取必要的事件資料後，必須連線至第三方會議系統來建立會議。用途通常是透過提出以及第三方會議系統查看第三方的說明文件用來決定可以使用哪些 API 要求建立會議。

在 Apps Script 中，如要處理外部 API 要求，最簡單的做法是使用 Apps Script 的 OAuth2 或 Apps Script 的 OAuth1 開放原始碼程式庫你也可以使用 UrlFetch 服務連線至外部 API，但您必須明確處理授權詳細資料。

要求建立會議後，你可能需要建立額外的擷取新會議詳細資料的要求。

初始化會議同步處理作業

一旦外掛程式成功在第三方系統中建立會議可能需要執行幾個步驟 Google 日曆活動就會反映在會議中。

請參閱同步處理日曆變更。

建立會議資料回應

使用第三方服務傳回的會議資訊， onCreateFunction 必須建構並傳回 ConferenceData object;這個會議資料部分會說明此物件的內容。Google 日曆會使用這項資訊並在會議開始後使用這些資訊將使用者導向會議。

建立 ConferenceData 時物件，請注意，欄位長度、格式進入點 URI 和允許使用的進入點組合。例如：一次最多只能有一個 VIDEO 進入點 ConferenceData。這些限制與說明中的限制相同日曆 API 事件 (相應事件的相應事件) conferenceData 欄位 (但其中說明並未描述的所有 API 事件欄位) 均支援 Apps Script。

處理錯誤

在某些情況下，無法完成會議建立作業，原因如下：。適用於以下情況您的外掛程式應該建立並傳回 ConferenceData敬上包含 ConferenceError 以便 Google 日曆採取相應措施

建構 ConferenceData 物件來回報錯誤時，，則除了提供ConferenceData ConferenceError 物件。ConferenceErrors 可以 ConferenceErrorType, 如果發生驗證問題，則網址使用者登入第三方會議系統。

範例

以下範例為 onCreateFunction (請注意，函式可以是任何內容您只需在外掛程式專案中資訊清單)。

函式 create3rdPartyConference() 與第三方系統聯絡建立會議，並使用 getAuthenticationUrl() 函式建立第三方系統驗證網址。系統不會在不過，它們高度依賴第三方系統的詳細資料。

initializeSyncing() 函式不會顯示在這裡；模型就會處理需要執行某些工作才能同步請參閱同步處理日曆變更。

/**
 *  Creates a conference, then builds and returns a ConferenceData object
 *  with the corresponding conference information. This method is called
 *  when a user selects a conference solution defined by the add-on that
 *  uses this function as its 'onCreateFunction' in the add-on manifest.
 *
 *  @param {Object} arg The default argument passed to a 'onCreateFunction';
 *      it carries information about the Google Calendar event.
 *  @return {ConferenceData}
 */
function createConference(arg) {
  const eventData = arg.eventData;
  const calendarId = eventData.calendarId;
  const eventId = eventData.eventId;

  // Retrieve the Calendar event information using the Calendar
  // Advanced service.
  var calendarEvent;
  try {
    calendarEvent = Calendar.Events.get(calendarId, eventId);
  } catch (err) {
    // The calendar event does not exist just yet; just proceed with the
    // given event ID and allow the event details to sync later.
    console.log(err);
    calendarEvent = {
      id: eventId,
    };
  }

  // Create a conference on the third-party service and return the
  // conference data or errors in a custom JSON object.
  var conferenceInfo = create3rdPartyConference(calendarEvent);

  // Build and return a ConferenceData object, either with conference or
  // error information.
  var dataBuilder = ConferenceDataService.newConferenceDataBuilder();

  if (!conferenceInfo.error) {
    // No error, so build the ConferenceData object from the
    // returned conference info.

    var phoneEntryPoint = ConferenceDataService.newEntryPoint()
        .setEntryPointType(ConferenceDataService.EntryPointType.PHONE)
        .setUri('tel:+' + conferenceInfo.phoneNumber)
        .setPin(conferenceInfo.phonePin);

    var adminEmailParameter = ConferenceDataService.newConferenceParameter()
        .setKey('adminEmail')
        .setValue(conferenceInfo.adminEmail);

    dataBuilder.setConferenceId(conferenceInfo.id)
        .addEntryPoint(phoneEntryPoint)
        .addConferenceParameter(adminEmailParameter)
        .setNotes(conferenceInfo.conferenceLegalNotice);

    if (conferenceInfo.videoUri) {
      var videoEntryPoint = ConferenceDataService.newEntryPoint()
          .setEntryPointType(ConferenceDataService.EntryPointType.VIDEO)
          .setUri(conferenceInfo.videoUri)
          .setPasscode(conferenceInfo.videoPasscode);
      dataBuilder.addEntryPoint(videoEntryPoint);
    }

    // Since the conference creation request succeeded, make sure that
    // syncing has been enabled.
    initializeSyncing(calendarId, eventId, conferenceInfo.id);

  } else if (conferenceInfo.error === 'AUTH') {
    // Authenentication error. Implement a function to build the correct
    // authenication URL for the third-party conferencing system.
    var authenticationUrl = getAuthenticationUrl();
    var error = ConferenceDataService.newConferenceError()
        .setConferenceErrorType(
            ConferenceDataService.ConferenceErrorType.AUTHENTICATION)
        .setAuthenticationUrl(authenticationUrl);
    dataBuilder.setError(error);

  } else {
    // Other error type;
    var error = ConferenceDataService.newConferenceError()
        .setConferenceErrorType(
            ConferenceDataService.ConferenceErrorType.TEMPORARY);
    dataBuilder.setError(error);
  }

  // Don't forget to build the ConferenceData object.
  return dataBuilder.build();
}


/**
 *  Contact the third-party conferencing system to create a conference there,
 *  using the provided calendar event information. Collects and retuns the
 *  conference data returned by the third-party system in a custom JSON object
 *  with the following fields:
 *
 *    data.adminEmail - the conference administrator's email
 *    data.conferenceLegalNotice - the conference legal notice text
 *    data.error - Only present if there was an error during
 *         conference creation. Equal to 'AUTH' if the add-on user needs to
 *         authorize on the third-party system.
 *    data.id - the conference ID
 *    data.phoneNumber - the conference phone entry point phone number
 *    data.phonePin - the conference phone entry point PIN
 *    data.videoPasscode - the conference video entry point passcode
 *    data.videoUri - the conference video entry point URI
 *
 *  The above fields are specific to this example; which conference information
 *  your add-on needs is dependent on the third-party conferencing system
 *  requirements.
 *
 * @param {Object} calendarEvent A Calendar Event resource object returned by
 *     the Google Calendar API.
 * @return {Object}
 */
function create3rdPartyConference(calendarEvent) {
  var data = {};

  // Implementation details dependent on the third-party system API.
  // Typically one or more API calls are made to create the conference and
  // acquire its relevant data, which is then put in to the returned JSON
  // object.

  return data;
}

/**
 *  Return the URL used to authenticate the user with the third-party
 *  conferencing system.
 *
 *  @return {String}
 */
function getAuthenticationUrl() {
  var url;
  // Implementation details dependent on the third-party system.

  return url;
}