ショッピング キャンペーンを作成する前に、まず以下の手順で Google 広告アカウントを Google Merchant Center アカウントにリンクする必要があります。
- Merchant Center アカウントから Google 広告アカウントにリンク リクエストを送信します。
- Google 広告アカウントでリンク リクエストを承認します。
Merchant Center アカウントからリンク リクエストを送信する
リンク リクエストを送信する方法は 2 つあります。
- Merchant Center ウェブ インターフェースを使用してリンク リクエストを送信する。
- Content API for Shopping を使用して、
Account
のadsLinks
を更新します。
Google 広告アカウントでリンク リクエストを管理する
Google 広告アカウントで Merchant Center リンクのステータスを変更するには、Google 広告のウェブ インターフェースを使用して招待を承認または拒否します。以下で説明するように、Google Ads API を使用して招待状を更新したり、既存のリンクを削除したりすることもできます。
すべての Merchant Center の招待状を一覧表示する
次の GAQL クエリを使用して Google 広告 API レポートを実行すると、Google 広告のお客様 ID を Merchant Center アカウントにリンクするための保留中のすべての招待状のリストを取得できます。
SELECT
product_link_invitation.merchant_center.merchant_center_id,
product_link_invitation.type
FROM product_link_invitation
WHERE product_link_invitation.status = 'PENDING_APPROVAL'
AND product_link_invitation.type = 'MERCHANT_CENTER'
すべての招待状を取得するには、上記のクエリで product_link_invitation.status
フィールドのフィルタ条件を削除します。
招待の承諾
リンクを承認するには、product_link_invitation
ステータスを ACCEPTED
に設定します。
UpdateProductLinkInvitationRequest
オブジェクトを作成し、customer_id
フィールドを Google 広告のお客様 ID として設定します。resource_name
フィールドをproduct_link_invitation
のリソース名に設定します。product_link_invitation_status
をACCEPTED
に設定します。UpdateProductLinkInvitation
API 呼び出しを行います。
両方のアカウントですでに管理者権限を持っているユーザーが招待フローを試行すると、NO_INVITATION_REQUIRED
エラーがスローされます。このような場合は、このエラーをチェックし、直接リンクフローにフォールバックできます。
招待を拒否する
招待を拒否する処理は、招待を承諾する処理と似ていますが、product_link_invitation_status
フィールドが REJECTED
に設定される点が異なります。招待が拒否された場合、招待は REJECTED
状態のままになり、承認できません。必要に応じて、新しい招待状を作成する必要があります。
招待なしの直接リンク
Google 広告アカウントを Merchant Center アカウントにリンクしようとしているユーザーが、両方のアカウントの管理者である場合は、招待の手順をスキップして、Google Ads API を使用して両方のアカウントを直接リンクできます。
CreateProductLinkRequest
オブジェクトを作成し、customer_id
フィールドを Google 広告のお客様 ID として設定します。新しい
ProductLink
オブジェクトを作成し、そのmerchant_center_id
フィールドを Merchant Center アカウントの ID に設定します。ProductLink
をリクエスト オブジェクトのproduct_link
フィールドに設定します。CreateProductLink
API 呼び出しを行います。
十分な権限を持たないユーザーが直接リンクを試みると、CREATION_NOT_PERMITTED
エラーがスローされます。このエラーを確認して、そのような場合は招待フローにフォールバックできます。
すべての Merchant Center リンクを一覧表示する
次の GAQL クエリを使用して Google Ads API レポートを実行し、Google 広告のお客様 ID のリンクのリストを取得できます。
SELECT
product_link.merchant_center.merchant_center_id,
product_link.product_link_id
FROM product_link
WHERE product_link.type = 'MERCHANT_CENTER'
リンクのリンクを解除する
リンクを解除する手順は次のとおりです。
RemoveProductLinkRequest
オブジェクトを作成し、customer_id
フィールドを Google 広告のお客様 ID として設定します。product_link
のリソース名としてresource_name
を設定します。RemoveProductLink
API 呼び出しを行います。
ビジネス マネージャー
ビジネス マネージャーは、Google におけるビジネスの統合された表現です。ビジネス マネージャー アカウントを使用して Google 広告アカウントと Merchant Center アカウントの両方を管理すると、ビジネス マネージャーによって Google 広告アカウントと Merchant Center アカウントのリンクが自動的に作成されます。これらのリンクは Google Ads API を使用して取得できますが、Google Ads API を使用して変更することはできません。