ショッピング キャンペーンを作成する前に、まず以下の手順で 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に設定します。UpdateProductLinkInvitationAPI 呼び出しを行います。
両方のアカウントですでに管理者権限を持っているユーザーが招待フローを試みると、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フィールドに設定します。CreateProductLinkAPI 呼び出しを行います。
十分な権限を持たないユーザーが直接リンクを試みると、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を設定します。RemoveProductLinkAPI 呼び出しを行います。
ビジネス マネージャー
ビジネス マネージャーは、Google におけるビジネスの統合された表現です。ビジネス マネージャー アカウントを使用して Google 広告アカウントと Merchant Center アカウントの両方を管理すると、ビジネス マネージャーによって Google 広告アカウントと Merchant Center アカウントのリンクが自動的に作成されます。これらのリンクは Google Ads API を使用して取得できますが、Google Ads API を使用して変更することはできません。