Method: accounts.updateNotificationSetting
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アカウントの Pub/Sub 通知設定を設定して、Pub/Sub 通知を送信するトピックを Google に通知します。notificationSetting 内の notificationTypes フィールドを使用して、アカウントが登録するイベントを操作します。
各アカウントで使用できる通知設定リソースは 1 つだけです。また、設定できる Pub/Sub トピックは 1 つのみです。設定を削除するには、空の notificationTypes を使用して更新します。
HTTP リクエスト
PATCH https://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
notificationSetting.name |
string
必須。この設定の対象となるリソース名。形式は accounts/{account_id}/notificationSetting です。
|
クエリ パラメータ
パラメータ |
updateMask |
string (FieldMask format)
必須。更新するフィールドです。編集可能なフィールドは notificationSetting のみです。 完全修飾フィールド名のカンマ区切りリストです。(例: "user.displayName,photo" )。
|
リクエストの本文
リクエストの本文には NotificationSetting
のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には NotificationSetting
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/business.manage
詳細については、OAuth 2.0 の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eAllows configuration of Pub/Sub notification settings for Google My Business accounts to receive event updates.\u003c/p\u003e\n"],["\u003cp\u003eOnly one notification setting and Pub/Sub topic are allowed per account; update with empty notificationTypes to delete the setting.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUses a PATCH request to \u003ccode\u003ehttps://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}\u003c/code\u003e to update settings.\u003c/p\u003e\n"],["\u003cp\u003eProvides a \u003ccode\u003enotificationTypes\u003c/code\u003e field within the \u003ccode\u003enotificationSetting\u003c/code\u003e object for managing event subscriptions.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.updateNotificationSetting\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nSets the pubsub notification setting for the account informing Google which topic to send pubsub notifications for. Use the notificationTypes field within notificationSetting to manipulate the events an account wants to subscribe to.\n\nAn account will only have one notification setting resource, and only one pubsub topic can be set. To delete the setting, update with an empty notificationTypes\n\n### HTTP request\n\n`PATCH https://mybusinessnotifications.googleapis.com/v1/{notificationSetting.name=accounts/*/notificationSetting}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `notificationSetting.name` | `string` Required. The resource name this setting is for. This is of the form `accounts/{account_id}/notificationSetting`. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields that should be updated. The only editable field is notificationSetting. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [NotificationSetting](/my-business/reference/notifications/rest/v1/NotificationSetting).\n\n### Response body\n\nIf successful, the response body contains an instance of [NotificationSetting](/my-business/reference/notifications/rest/v1/NotificationSetting).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]