Merchant Accounts API のリリースノート

2026 年 9 月 28 日の週

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

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 を持つサービスが 2 つ存在してはなりません。

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

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

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

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

  • 呼び出しを行うユーザーを表す User リソースの PENDING から VERIFIED への状態の更新を可能にする VerifySelf メソッドを UserService に追加しました。

  • 販売者が半径エリアを使用して地域を作成できるようにする、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: 単一のリクエストで複数のリージョンを更新できるようにします。
    • 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 は accounts/... 形式（providers/... ではなく）で呼び出す必要があることを明確にしました。これは、このメソッドが 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 のベータ版リリース