Acl: watch

注意：需要授權。

查看 ACL 資源的變更。

要求

HTTP 要求

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch

參數

參數名稱	值	說明
路徑參數
calendarId	string	日曆 ID。如要擷取日曆 ID，請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆，請使用 [primary] 關鍵字。

授權

此要求需要以下範圍的授權：

範圍
https://www.googleapis.com/auth/calendar

詳情請參閱驗證和授權頁面。

要求主體

在要求內容中，請按照下列結構提供資料：

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

資源名稱	值	說明	Notes
id	string	用於識別這個頻道的 UUID 或類似的不重複字串。
token	string	傳送至目標地址的任意字串，且會透過此管道傳送每則通知。選用。
type	string	此管道使用的放送機制類型。有效值為「web_hook」(或「webhook」)。這兩個值都是指透過 HTTP 要求來傳遞訊息的管道。
address	string	接收此頻道通知的電子郵件地址。
params	object	用來控制放送管道行為的其他參數。選用。
params.ttl	string	通知管道的存留時間 (單位為秒)。預設值為 604800 秒。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

屬性名稱	值	說明	Notes
kind	string	這會做為通知管道，用於監控資源變更 (「api#channel」) 的變更。
id	string	用於識別這個頻道的 UUID 或類似的不重複字串。
resourceId	string	不識別頻道 ID 以識別正在觀看的頻道。採用不同 API 版本。
resourceUri	string	所查看資源的版本專屬 ID。
token	string	傳送至目標地址的任意字串，且會透過此管道傳送每則通知。選用。
expiration	long	通知管道到期時間，以 Unix 時間戳記表示 (以毫秒為單位)。選用。