Merchant Accounts API のリリースノート

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