ホームページの設定を移行する

Merchant API に専用の Homepage リソースが導入されました。このリソースでは、ホームページの申し立てを管理するための新しいメソッドが提供され、従来の Content API for Shopping を超える機能が提供されます。

オンライン ショップの機能にアクセスするには、まず所有権を確認し、次にアカウントのサイトを申請する 2 つの手続きが必要です。最後の手順を完了するには、accounts.homepage.claim を使用します。

主な違い

Merchant API では、Content API for Shopping と比較して、ホームページ関連の変更がいくつか行われています。

  • 専用リソース: Merchant API は、ホームページ関連のすべてのオペレーションに対して個別の Homepage リソース（accounts.homepage）を提供します。（Content API for Shopping では、accounts.claimwebsite を使用して所有権の申し立てアクションを実行し、ホームページの URL（website_url）は Account リソースの一部で、所有権の申し立てステータス（website_claimed）は AccountStatus リソースの一部でした）。
  • きめ細かいメソッド: Merchant API は、次の操作を行うための特定のメソッドを提供します。
    • ホームページの詳細を取得する: accounts.homepage.getHomepage
    • ホームページの URI を更新します。accounts.homepage.updateHomepage
    • ホームページを申し立てる: accounts.homepage.claim
    • ホームページの所有権を放棄する: accounts.homepage.unclaim ショッピング用 Content API では、所有権の主張アクションに accounts.claimwebsite、URL の設定（空の URL を設定して所有権を放棄）に accounts.update、URL と所有権のステータスの取得にそれぞれ accounts.get/accountstatuses.get が使用されていました。
  • 情報の一元化: Merchant API の Homepage リソースには、uri（ホームページの URL）と claimed ステータスの両方が直接含まれています。Homepage リソースで動作するすべてのメソッドは、このリソースを返し、現在の状態に関するフィードバックをすぐに提供します。Content API for Shopping では、accounts.claimwebsite は更新されたステータスを返さなかったため、個別の呼び出しが必要でした。
  • 明示的な免責条項: Content API for Shopping では、通常、Account.website_url を空の文字列に更新することで免責条項が適用されていました。Merchant API は、専用の homepage.unclaim メソッドを提供します。
  • 申請の上書き: どちらの API も、申請プロセス中に overwrite パラメータをサポートしています。所有権を確認できる場合は、別のユーザーのアカウントから申請を引き継ぐことができます。

リクエスト

Merchant API は、ホームページのさまざまな側面を管理するために、個別の RESTful エンドポイントを使用します。

リクエストの説明 Content API for Shopping Merchant API
ホームページの詳細を取得する accounts.get（Account.website_url を読み取る）、accountstatuses.get（AccountStatus.website_claimed を読み取る） GET /accounts/v1/accounts/{account}/homepage
ホームページの URI を更新する accounts.update（Account.website_url の設定） PATCH /accounts/v1/accounts/{account}/homepage
ホームページの申請または再確認を行う POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite（accounts.update を使用して設定された Account.website_url に作用） POST /accounts/v1/accounts/{account}/homepage:claim
ホームページの免責事項 accounts.update（Account.website_url を空の文字列に設定） POST /accounts/v1/accounts/{account}/homepage:unclaim

識別子

Merchant API でリソースの識別が効率化されました。

識別子の説明 Content API for Shopping Merchant API
リソース アクセスのアカウント ID パス内の merchantId（アドバンス アカウント）と accountId（サブアカウント） account（name フィールドの一部、例: accounts/{account_id}/homepage）
ホームページのリソース ID 該当なし（Account リソースに暗黙的に適用） name: accounts/{account_id}/homepage（Homepage サブリソースを識別します）

メソッド

Content API for Shopping の accounts.claimwebsite メソッドは、以前は所有権の申し立てに特化していましたが、現在は Merchant API の Homepage リソース内の幅広い機能の一部となっています。

Content API for Shopping メソッド Merchant API メソッド 提供状況と注意事項
accounts.claimwebsite accounts.homepage.claim ウェブサイトの所有権の申請を直接開始または再確認します。homepage.update を使用して以前に設定された uri に対して動作します。overwrite パラメータが含まれます。現在の uri ステータスと claimed ステータスを含む Homepage リソースを返します。
accounts.get（Account.website_url を読み取る）、accountstatuses.get（AccountStatus.website_claimed を読み取る） accounts.homepage.getHomepage 現在のホームページの uri とその claimed ステータスを 1 回の呼び出しで取得する新しい専用メソッド。
accounts.update（Account.website_url を設定） accounts.homepage.updateHomepage ホームページ uri を設定または変更するための新しい専用メソッド。
accounts.update（登録解除の回避策として Account.website_url を空の文字列に設定） accounts.homepage.unclaim ホームページの所有権を明示的に解除するための新しい専用メソッド。

フィールドの変更の詳細

ホームページ情報の構造とアクセス方法が大幅に変更され、Merchant API の明示的な Homepage リソースに移行しました。

Content API for Shopping Merchant API 説明
merchantId（accounts.claimwebsite のパスパラメータ） name（Homepage メソッドのパスパラメータ、形式: accounts/{account}/homepage） Merchant API の name 文字列の account 部分は、Content API for Shopping の accountId に対応しています。
accountId（accounts.claimwebsite のパスパラメータ） name（Homepage メソッドのパスパラメータ、形式: accounts/{account}/homepage） ホームページが管理されている特定のアカウントの識別子。
overwrite（ContentAccountsClaimwebsiteRequest 本文と AccountsCustomBatchRequestEntry のブール値） ClaimHomepageRequest.overwrite（homepage.claim リクエスト本文のブール値） 省略可。true の場合、ウェブサイトの申請を試みます。リクエストしているアカウントで所有権を確認できる場合は、別のアカウントの既存の申請が削除される可能性があります。
Account.website_url（Account リソースのフィールド。accounts.update を使用して設定し、accounts.get を使用して読み取る） Homepage.uri（Homepage リソースのフィールド） ストアのホームページの URI（URL）。Merchant API では、これは Homepage リソース内の明示的なフィールドです。accounts.homepage.updateHomepage を使用して設定され、すべての Homepage メソッドによって返されます。
AccountStatus.website_claimed（AccountStatus リソースのフィールド、accountstatuses.get を使用して読み取り） Homepage.claimed（Homepage リソースの output_only ブール値フィールド） uri が申請され、確認されているかどうかを示します。このステータスは、関連するすべての Merchant API メソッドから返される Homepage リソースで直接確認できます。
なし UpdateHomepageRequest.update_mask accounts.homepage.updateHomepage リクエスト本文パラメータ） homepage.update の省略可能なフィールド マスク。どのフィールド（例: Homepage リソースの uri が更新されています。
前へ
Migrate user and access management
次へ
Migrate region management