Merchant Accounts API のリリースノート

2025 年 11 月 10 日の週

  • Services API の v1alpha バージョンを公開します。
  • Services API の CampaignManagement ペイロードに新しい product_filters フィールドを導入します。これにより、販売者は、販売者の商品の属性に対する条件付きフィルタリングに基づいて、フィードのサブセットのみを Google 広告アカウントと共有できるようになります。この機能は許可リストに登録された一部の販売者のみが利用できます。

2025 年 8 月 25 日の週

  • Regions API に新しいバッチ メソッドが追加されました。
    • BatchCreateRegions: 1 回のリクエストで複数のリージョンを作成できます。
    • BatchUpdateRegions: 単一のリクエストで複数のリージョンを更新できます。
    • BatchDeleteRegions: 1 つのリクエストで複数のリージョンを名前で削除する機能を提供します。

2025 年 7 月 1 日の週

  • API ユーザーが checkoutSettings を作成、更新、削除、取得できる CheckoutSettings リソースのリリース。

2025 年 5 月 26 日の週

  • capabilities でアカウントをフィルタできるようになりました。現時点では、指定できる値は CAN_UPLOAD_PRODUCTS のみです。このフィルタを使用すると、商品をアップロードできるアカウントを取得できます。つまり、次の条項をアカウント単位で使用できるようになりました。

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS 詳細については、フィルタリング ガイドをご覧ください。

  • 読み取り専用アクセス権のリリース。読み取り専用のアクセス権を持つユーザーは、販売者データを表示できますが、変更することはできません。

2025 年 5 月 19 日の週

  • プログラム API のドキュメントを更新し、Enable メソッドと Disable メソッドが管理者ユーザーに制限されるという誤った記述を削除しました。

2025 年 5 月 12 日の週

  • API ユーザーが返品ポリシーの作成、更新、削除を行えるオンライン返品ポリシー リソースのリリース。
  • API ユーザーがオムニチャネル エクスペリエンスを管理できるようにする OmnichannelSettingsService と OmnichannelSetting リソースをリリースしました。
  • API ユーザーがローカル フィード パートナーシップの関係を管理できるようにする LfpProvidersService と LfpProvider リソースのリリース。
  • API ユーザーが Google ビジネス プロフィールを管理できるようにする GbpAccountsService と GbpAccount リソースのリリース。
    • AccountService で LocalListingManagement サービスタイプを起動します。このサービスタイプは、ローカル在庫広告または無料ローカル リスティングに使用されるビジネス グループをリンクします。

2025 年 4 月 28 日の週

  • API ユーザーが関係を管理し、サービス プロバイダへのサービスを確立できる AccountService リソースと AccountRelationship リソースのリリース。

2025 年 4 月 14 日の週

  • TermsOfServiceService.AcceptTermsOfService は、レスポンス タイプでラップされた受け入れ済みの TermsOfServiceAgremeentState を返すようになりました。

  • TermsOfServiceService.AcceptTermsOfService アクションの動詞が POST になりました（以前は GET でした）。

  • AccountsService.ListSubAccounts は providers/... ではなく accounts/... 形式で呼び出す必要があることを明確にしました。これは、このメソッドが accounts スコープから外れるのを防ぐためです（つまり、GET providers/123:listSubAccounts ではなく GET accounts/123:listSubAccounts）。

2025 年 3 月 31 日の週

  • アカウントのフィルタリングについては、2024 年 12 月 2 日の週に externalAccountId フィルタのサポート終了が発表され、現在は利用できなくなっています。つまり、externalAccountId によるフィルタリングは service レベルでのみ可能になります。relationship(externalAccountId = "foo") などのフィルタは機能しなくなるため、relationship(service(externalAccountId = "foo")) として表現する必要があります。

  • AccountsService のドキュメントで、スタンドアロン アカウントを作成できないことを明確にしました。

2025 年 3 月 3 日の週

- accounts.onlineReturnPolicies#SeasonalOverride をリファクタリングして、明確さと一貫性を高めました。この更新には以下の内容が含まれます。

  • フィールド名の変更:
    • begin を start_date に変更
    • end を end_date に変更
  • フィールドの削除:
    • 非推奨の policy フィールドが削除されました。

- デベロッパーは、これらの変更を反映するようにコードを更新する必要があります。

次の管理に使用できる AutomaticImprovements サービスのリリース:

詳細については、自動改善を有効にするをご覧ください。

2025 年 2 月 17 日の週

アカウント フィルタから callerHasAccessToProviderFilter() 述語を削除しました。

2025 年 2 月 10 日の週

  • AccountsService.List メソッドのドキュメントを改善しました。独立したアカウントだけでなく、ユーザーがアクセスできるすべてのアカウントが返されます。

  • すべての RPC メソッドにデフォルトの期限（10 分）を追加しました。

  • 利用可能なプログラム名のリストを accounts.programs リソースの説明に追加しました。

  • User.accessRights が REQUIRED になり、UserService.Create メソッドと AccountsService.CreateAndConfigure メソッドの両方に影響します。

2025 年 1 月 27 日の週

AccountsService.ListAccounts（および推移的に AccountsService.ListSubAccounts）は、強力な読み取りではなく、結果整合性のある方法でアカウントを返すようになりました。

2025 年 1 月 20 日の週

CreateAndConfigureAccountRequest の users フィールドは非推奨となり、新しい user に置き換えられました。参照された CreateUserRequest に、CreateAndConfigureAccountRequest のコンテキストで必須ではない parent フィールドが含まれています。

2025 年 1 月 6 日の週

CreateUserRequest メッセージの user フィールドが OPTIONAL として正しくマークされるようになりました。

返されるエラーの domain フィールドに、global ではなく merchantapi.googleapis.com が入力されるようになりました

2024 年 12 月 2 日の週

アカウントのフィルタリングでは、externalAccountId 述語が relationship レベルから service レベルに移動します。そのため、フィルタ relationship(externalAccountId = "foo") は relationship(service(externalAccountId = "foo")) と記述する必要があります。以前の形式は下位互換性のために引き続きサポートされますが、非推奨となっており、近い将来にエラーがスローされるようになります。すべてのドキュメントで新しい形式のみが言及されます。

2024 年 11 月 18 日の週

CreateAndConfigureAccountRequest.service.provider フィールドのプロバイダは、providers/GOOGLE_ADS または providers/GOOGLE_BUSINESS_PROFILE のいずれかにすることもできます。他のアカウントは providers/123（accounts/123 ではなく）として参照する必要があります。つまり、フィールドはアカウント参照としてアノテーションされなくなります。ただし、下位互換性のため、accounts/123 などのアカウント名を使用することもできます。

ListSubAccountsRequest のプロバイダは providers/123 の形式になりますが、下位互換性のために accounts/123 を引き続き使用することもできます。

2024 年 11 月 4 日の週

BusinessIdentity リソースで promotions_consent REQUIRED（OPTIONAL から）をマークします。これは更新メソッドにのみ影響します。これは、promotions_consent を UNSPECIFIED に更新できないことを明確にするためです。これはすでに不可能でしたが、エラーの説明がより詳細になり、フィールドに正しいアノテーションが付けられるようになりました。

2024 年 10 月 28 日の週

User、Homepage、BusinessInfo などの Accounts サブ API のさまざまなリソースのドキュメントを改善します。

2024 年 10 月 21 日の週

更新リクエストの update_mask フィールドのドキュメントを改善し、更新でサポートされているフィールドを明確に示しました。

ShippingSettings リソースの外部ドキュメントに、サポートされている携帯通信会社の Google ビジネス ヘルプセンターのリンクを追加しました

2024 年 10 月 14 日の週

AccountsService.CreateAndConfigureAccountRequest.AddAccountService で provider を REQUIRED としてマークします。

Accounts サブ API（ビジネス ID、ビジネス情報、ホームページなど）全体で update_mask を省略可能にし、ConversionSources リソースに対して遡及的に適用します。

ClaimHomepageRequest に overwrite パラメータを追加しました。

2024 年 9 月 30 日の週

Accounts.delete メソッドの「force」パラメータのリリース。

2024 年 9 月 23 日の週

RetrieveLatestTermsOfServiceRequest で region_code と kind を REQUIRED としてマークします。

2024 年 9 月 16 日の週

ListAccountIssuesRequest で time_zone パラメータの型を文字列に変更しました

2024 年 8 月 12 日の週

BusinessInfo リソースに korean_business_registration_number フィールドを追加しました。

2024 年 5 月 27 日の週

Accounts サブ API のベータ版リリース