Class ConferenceError
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
會議錯誤
在會議外掛程式中發生的錯誤。使用範例:
const conferenceError =
ConferenceDataService.newConferenceError().setConferenceErrorType(
ConferenceDataService.ConferenceErrorType.PERMANENT,
);
驗證範例:
const state = ScriptApp.newStateToken()
.withMethod('myLoginCallbackFunction')
.withTimeout(3600)
.createToken();
const authenticationUrl = `https://script.google.com/a/google.com/d/${
ScriptApp.getScriptId()}/usercallback?state=${state}`;
const conferenceError =
ConferenceDataService.newConferenceError()
.setConferenceErrorType(
ConferenceDataService.ConferenceErrorType.AUTHENTICATION,
)
.setAuthenticationUrl(authenticationUrl);
內容詳盡的說明文件
setAuthenticationUrl(authenticationUrl)
如果錯誤類型為 AUTHENTICATION
,外掛程式必須提供可回呼至外掛程式的網址,讓使用者登入。這個欄位的長度上限為 1800 個半形字元。
參數
名稱 | 類型 | 說明 |
authenticationUrl | String | 要設定的驗證網址。 |
回攻員
ConferenceError
:這個物件,用於鏈結
擲回
Error
:如果提供的網址不是有效的 http/https 網址或過長。
setConferenceErrorType(conferenceErrorType)
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-28 (世界標準時間)。
[null,null,["上次更新時間:2025-07-28 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eConferenceError\u003c/code\u003e objects represent errors that occur within conferencing add-ons and can be created using \u003ccode\u003eConferenceDataService.newConferenceError()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThese errors have a type, which can be set using \u003ccode\u003esetConferenceErrorType()\u003c/code\u003e, and may require an authentication URL if the type is \u003ccode\u003eAUTHENTICATION\u003c/code\u003e, set using \u003ccode\u003esetAuthenticationUrl()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf the error type is \u003ccode\u003eAUTHENTICATION\u003c/code\u003e, the provided authentication URL should redirect users back to the add-on for login purposes and should be a valid http/https URL with a maximum length of 1800 characters.\u003c/p\u003e\n"],["\u003cp\u003eBoth \u003ccode\u003esetAuthenticationUrl()\u003c/code\u003e and \u003ccode\u003esetConferenceErrorType()\u003c/code\u003e return the \u003ccode\u003eConferenceError\u003c/code\u003e object itself, enabling method chaining for easier error configuration.\u003c/p\u003e\n"]]],[],null,["# Class ConferenceError\n\nConferenceError\n\nError that occurred in a conferencing add-on. Example usage:\n\n```javascript\nconst conferenceError =\n ConferenceDataService.newConferenceError().setConferenceErrorType(\n ConferenceDataService.ConferenceErrorType.PERMANENT,\n );\n```\nExample with authentication: \n\n```javascript\nconst state = ScriptApp.newStateToken()\n .withMethod('myLoginCallbackFunction')\n .withTimeout(3600)\n .createToken();\n\nconst authenticationUrl = `https://script.google.com/a/google.com/d/${\n ScriptApp.getScriptId()}/usercallback?state=${state}`;\n\nconst conferenceError =\n ConferenceDataService.newConferenceError()\n .setConferenceErrorType(\n ConferenceDataService.ConferenceErrorType.AUTHENTICATION,\n )\n .setAuthenticationUrl(authenticationUrl);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------------------------------------------|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [setAuthenticationUrl(authenticationUrl)](#setAuthenticationUrl(String)) | [ConferenceError](#) | If the error type is [AUTHENTICATION](/apps-script/reference/conference-data/conference-error-type#AUTHENTICATION), the add-on must provide a URL calling back into the add-on to allow users to log in. |\n| [setConferenceErrorType(conferenceErrorType)](#setConferenceErrorType(ConferenceErrorType)) | [ConferenceError](#) | Sets the error type of this [ConferenceError](#). |\n\nDetailed documentation\n----------------------\n\n### `set``Authentication``Url(authenticationUrl)`\n\nIf the error type is [AUTHENTICATION](/apps-script/reference/conference-data/conference-error-type#AUTHENTICATION), the add-on must\nprovide a URL calling back into the add-on to allow users to log in. The maximum length for\nthis field is 1800 characters.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------------------|----------|--------------------------------|\n| `authentication``Url` | `String` | The authentication URL to set. |\n\n#### Return\n\n\n[ConferenceError](#) --- this object, for chaining\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the provided URL is not a valid http/https URL or is too\nlong.\n\n*** ** * ** ***\n\n### `set``Conference``Error``Type(conferenceErrorType)`\n\nSets the error type of this [ConferenceError](#).\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------------------|-------------------------------------------------------------------------------------|---------------------------|\n| `conference``Error``Type` | [ConferenceErrorType](/apps-script/reference/conference-data/conference-error-type) | The type of error to set. |\n\n#### Return\n\n\n[ConferenceError](#) --- this object, for chaining"]]