Merchant Accounts API のリリースノート

2026 年 10 月 26 日の週

  • accounts.homepage.unclaim メソッドと Homepage リソースの claimed フィールドのドキュメントを明確にしました。アカウントがアドバンス アカウントからホームページの申請を継承している場合、unclaim は成功レスポンスを返しますが、ホームページは申請されたままになります。アカウント自体が申し立てから除外されている場合、unclaim は FAILED_PRECONDITION エラーを返します。

2026 年 9 月 28 日の週

  • v1alpha の AccountService リソースにサービスタイプとして youtube_affiliate_management を追加しました。注: YouTube アフィリエイト管理は、アクセスが制限されている機能です。

  • ポイント プログラムの管理に使用できる LoyaltyPrograms サービスのアルファ版リリース。この機能は、一部の販売者のみが利用できます。詳しくは、ポイント プログラムの概要をご覧ください。

  • 読み取り専用の home_page_uri フィールドを accounts リソースに追加して、ストアのホームページの URI を返すようにしました。

2026 年 8 月 3 日の週

  • アカウント サービス リソースにサービスタイプとして「ucp_checkout_management」を追加しました。注: UCP の購入手続きは、アクセスが制限された機能です。
  • 「ucp-integration」プログラムのサポートを追加しました（アクセス制限あり）。
  • 「ucp_integration」利用規約の種類のサポートを追加しました。

2026 年 6 月 29 日の週

2026 年 4 月 20 日の週

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

2026 年 4 月 6 日の週

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

2026 年 3 月 16 日の週

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

2025 年 11 月 17 日の週

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

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

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

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

  • CreateAndConfigureAccountRequest の setAlias フィールドを使用して、アカウントの作成時にリレーションシップのエイリアスを設定できるようになりました。

  • UserService に VerifySelf メソッドを追加しました。これにより、通話を行っているユーザーを表す 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 日の週

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

2025 年 4 月 28 日の週

  • AccountService リソースと AccountRelationship リソースのリリース。これにより、API ユーザーは関係を管理し、サービス提供者にサービスを確立できます。

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 のいずれかになります。他のアカウントは、accounts/123 ではなく providers/123 として参照する必要があります。つまり、このフィールドはアカウント参照としてアノテーションされなくなりました。ただし、下位互換性のために、accounts/123 などのアカウント名を使用することもできます。

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

2024 年 11 月 4 日の週

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

2024 年 10 月 28 日の週

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

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 のベータ版リリース