Merchant Accounts API のリリースノート

2026 年 4 月 20 日の週

  • 使用可能なプログラム名のリストに youtube-affiliate を追加しました。 accounts.programs リソースの説明。
  • YouTube ショッピング アフィリエイトのプログラム API を有効にしました。Trusted Tester のみ利用可能です。

2026 年 4 月 6 日の週

  • 承認ステータスに WAITING 状態を追加しました。ショッピング比較サービス(CSS)の場合、WAITINGPENDINGESTABLISHED の間の移行状態です。 アカウントが新しい CSS に完全に移行する前に、元の CSS で必要なクリーンアップを行う必要がある場合に使用されます。

2026 年 3 月 16 日の週

  • Accounts API で CreateTestAccount メソッドをリリースしました。これにより、デベロッパーは、隔離されたサンドボックスのような環境で動作する専用のテスト アカウントをプログラムで作成し、統合の開発とテストを安全に行うことができます。

2025 年 11 月 17 日の週

  • CreateAndConfigureAccountRequest で、アカウントの設定時に構成できる新しいサービスが提供されるようになりました。AccountAggregationAccountManagementComparisonShopping のいずれか 1 つを指定する必要があります。また、任意の数の ProductsManagement サービスと CampaignsManagement サービスを指定することもできます。ただし、プロバイダと外部アカウント ID が同じサービスを 2 つ指定することはできません。

  • AccountsService.CreateAndConfigure メソッドで、確認メールを送信するかどうかを制御する設定が提供されるようになりました。

  • CreateAndConfigureAccountRequest.AddAccountServiceexternal_account_id フィールドが追加されました(このフィールドは AccountService リソースにすでに存在します)。CampaignsManagement サービスと ProductsManagement サービスとともに指定できます。

  • AccountService リソースに ComparisonShopping サービスを追加しました。詳しくは、https://support.google.com/merchants/answer/12653197 をご覧ください。

  • CreateAndConfigureAccountRequestsetAlias フィールドを使用して、アカウントの作成時に関係のエイリアスを設定できるようになりました。

  • UserServiceVerifySelf メソッドを追加しました。これにより、呼び出し元のユーザーを表す User リソースの 状態を PENDING から VERIFIED に更新できます。

  • Regions API の Region ペイロードに新しい radius_area フィールドをリリースしました。これにより、販売者は半径エリアを使用して地域を作成できます。

2025 年 11 月 10 日の週

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

2025 年 8 月 25 日の週

  • Regions API に新しいバッチ メソッドを追加しました。
    • BatchCreateRegions: 1 つのリクエストで複数の地域を作成できます。
    • BatchUpdateRegions: 1 つのリクエストで複数の地域を更新できます。
    • BatchDeleteRegions: 1 つのリクエストで複数の地域を名前で削除できます。

2025 年 7 月 1 日の週

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

2025 年 4 月 28 日の週

  • AccountService と AccountRelationship リソースをリリースしました。API ユーザーは、関係を管理し、サービス プロバイダにサービスを設定できます。

2025 年 4 月 14 日の週

  • TermsOfServiceService.AcceptTermsOfService が、同意した TermsOfServiceAgremeentState をレスポンス タイプでラップして返すようになりました。

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

  • AccountsService.ListSubAccountsaccounts/... 形式(providers/... ではなく)を使用して呼び出す必要があることを明確にしました。これは、 このメソッドが accounts スコープから外れないようにするためです(つまり GET providers/123:listSubAccounts ではなく GET accounts/123:listSubAccounts)。

2025 年 3 月 31 日の週

  • アカウントのフィルタリングについて、externalAccountId フィルタは 2024 年 12 月 2 日の週に非推奨となり、現在は使用できません。つまり、externalAccountId でのフィルタリングは service レベルでのみ可能になりました。 `relationship(externalAccountId = "foo")` などのフィルタは機能しなくなり、 そして `relationship(service(externalAccountId = "foo"))` として表現する必要があります。

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

2025 年 3 月 3 日の週

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

  • フィールド名の変更:
    • beginstart_date になりました。
    • endend_date になりました。
  • フィールドの削除:
    • 非推奨の policy フィールドを削除しました。

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

AutomaticImprovements サービスをリリースしました。このサービスを使用して、次のことを管理できます。

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

2025 年 2 月 17 日の週

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

2025 年 2 月 10 日の週

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

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

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

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

2025 年 1 月 27 日の週

AccountsService.ListAccounts (および推移的に AccountsService.ListSubAccounts)が、強整合性読み取りではなく、結果整合性でアカウントを返すようになりました。

2025 年 1 月 20 日の週

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

2025 年 1 月 6 日の週

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

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

2024 年 12 月 2 日の週

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

2024 年 11 月 18 日の週

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

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

2024 年 11 月 4 日の週

BusinessIdentity リソースで promotions_consentREQUIREDOPTIONAL から)としてマークしました。これは更新メソッドにのみ影響します。promotions_consentUNSPECIFIED に更新できないことを明確にするためです。これはすでに不可能でしたが、エラーがよりわかりやすくなり、フィールドに正しくアノテーションが付けられるようになりました。

2024 年 10 月 28 日の週

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

2024 年 10 月 21 日の週

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

ShippingSettings リソースの外部ドキュメントに、サポートされている運送業者の Google ビジネス ヘルプセンターのリンクを追加しました。

2024 年 10 月 14 日の週

AccountsService.CreateAndConfigureAccountRequest.AddAccountServiceproviderREQUIRED としてマークしました。

Accounts サブ API 全体(ビジネス アイデンティティ、ビジネス情報、ホームページなど)と ConversionSources リソースで、update_mask を省略可能にしました。

ClaimHomepageRequestoverwrite パラメータを追加しました。

2024 年 9 月 30 日の週

'Accounts.delete' メソッドの 'force' パラメータをリリースしました。

2024 年 9 月 23 日の週

RetrieveLatestTermsOfServiceRequestregion_codekindREQUIRED としてマークしました。

2024 年 9 月 16 日の週

ListAccountIssuesRequesttime_zone パラメータの型を文字列に変更しました。

2024 年 8 月 12 日の週

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

2024 年 5 月 27 日の週

Accounts サブ API のベータ版をリリースしました。