このページは Cloud Translation API によって翻訳されました。

WebhookNotification

JSON 表現

リソースの更新時に Google Analytics Data API から Webhook サーバーに Webhook 通知を送信するように、長時間実行オペレーションのリソースを構成します。

通知設定にはプライベートな値と自分の GCP プロジェクトにのみ表示されます。異なる GCP プロジェクトが、同じ長時間実行オペレーションリソースに異なる Webhook 通知を添付する場合があります。

JSON 表現
{ "uri": string, "channelToken": string }

フィールド

フィールド
`uri`	`string` 省略可。Webhook 通知を受信するウェブアドレス。長時間実行オペレーションリソースの状態が変化すると、このアドレスは POST リクエストを受け取ります。POST リクエストの本文と `sentTimestamp` フィールドの両方に、長時間実行オペレーションリソースの JSON バージョンが含まれます。送信されたタイムスタンプは、リクエストが送信されたエポックからの UNIX マイクロ秒を示します。リプレイされた通知を特定できます URI の例は `https://us-central1-example-project-id.cloudfunctions.net/example-function-1` です。 URI は HTTPS を使用し、ウェブサーバー上に有効な SSL 証明書があるサイトを指している必要があります。URI は、文字列の最大長を 128 文字にする必要があります。RFC 1738 の許可リストに登録された文字のみを使用する。 Webhook サーバーが通知を受信すると、5 秒以内に HTTP レスポンスのステータスコード 200 を返すことが期待されます。 Webhook 通知を使用するには URI が必要です。この Webhook サーバーへのリクエストには、サービスアカウント `google-analytics-audience-export@system.gserviceaccount.com` を認証する ID トークンが含まれます。ID トークンの詳細については、https://cloud.google.com/docs/authentication/token-types#id をご覧ください。Google Cloud Functions では、認証を要求するように関数を構成できます。Cloud IAM では、サービスアカウントの権限を Cloud Run 起動元（`roles/run.invoker`）に付与する必要があります。Google Cloud Functions の認証を渡す Webhook POST リクエストの Cloud Functions 起動元（`roles/cloudfunctions.invoker`）ロール。この API は、Webhook 通知を任意の URI に送信できます。Google Cloud Functions 以外の Webhook サーバーでは、Authorization Bearer ヘッダー内のこの ID トークンが不要な場合は無視する必要があります。
`channelToken`	`string` 省略可。チャンネルトークンは任意の文字列値で、文字列の最大長は 64 文字である必要があります。チャネルトークンを使用すると、Webhook 通知のソースを確認できます。これにより、なりすましメールを防ぐことができます。チャネルトークンは、Webhook POST リクエストの `X-Goog-Channel-Token` HTTP ヘッダーで指定されます。 Webhook 通知を使用するためにチャネルトークンは必要ありません。

uri

string

省略可。Webhook 通知を受信するウェブアドレス。長時間実行オペレーションリソースの状態が変化すると、このアドレスは POST リクエストを受け取ります。POST リクエストの本文と sentTimestamp フィールドの両方に、長時間実行オペレーションリソースの JSON バージョンが含まれます。送信されたタイムスタンプは、リクエストが送信されたエポックからの UNIX マイクロ秒を示します。リプレイされた通知を特定できます

URI の例は https://us-central1-example-project-id.cloudfunctions.net/example-function-1 です。

URI は HTTPS を使用し、ウェブサーバー上に有効な SSL 証明書があるサイトを指している必要があります。URI は、文字列の最大長を 128 文字にする必要があります。RFC 1738 の許可リストに登録された文字のみを使用する。

Webhook サーバーが通知を受信すると、5 秒以内に HTTP レスポンスのステータスコード 200 を返すことが期待されます。

Webhook 通知を使用するには URI が必要です。

この Webhook サーバーへのリクエストには、サービスアカウント google-analytics-audience-export@system.gserviceaccount.com を認証する ID トークンが含まれます。ID トークンの詳細については、https://cloud.google.com/docs/authentication/token-types#id をご覧ください。Google Cloud Functions では、認証を要求するように関数を構成できます。Cloud IAM では、サービスアカウントの権限を Cloud Run 起動元（roles/run.invoker）に付与する必要があります。Google Cloud Functions の認証を渡す Webhook POST リクエストの Cloud Functions 起動元（roles/cloudfunctions.invoker）ロール。この API は、Webhook 通知を任意の URI に送信できます。Google Cloud Functions 以外の Webhook サーバーでは、Authorization Bearer ヘッダー内のこの ID トークンが不要な場合は無視する必要があります。

channelToken

string

省略可。チャンネルトークンは任意の文字列値で、文字列の最大長は 64 文字である必要があります。チャネルトークンを使用すると、Webhook 通知のソースを確認できます。これにより、なりすましメールを防ぐことができます。チャネルトークンは、Webhook POST リクエストの X-Goog-Channel-Token HTTP ヘッダーで指定されます。

Webhook 通知を使用するためにチャネルトークンは必要ありません。