パートナー リンクを作成または削除する

PartnerLink リソースを作成または削除する方法は次のとおりです。Data Manager API では、次のアカウント タイプのパートナー リンクの作成がサポートされています。

  • Google 広告アカウント
  • ディスプレイ＆ビデオ 360 パートナー アカウントまたはディスプレイ＆ビデオ 360 広告主アカウント

CreatePartnerLinkRequest を送信して PartnerLink を作成します。

リクエスト本文を作成する

PartnerLink リソースを作成します。設定するフィールドは次のとおりです。

owning_account

リンクを所有する広告主アカウントを識別します。ProductAccount オブジェクトに設定します。

account_type を広告主アカウントの AccountType に設定します。

account_id を広告主アカウントの ID に設定します。

広告主様のタイプごとに使用する ID については、配信先とヘッダーのガイドをご覧ください。

partner_account

パートナー アカウントを識別します。ProductAccount オブジェクトに設定します。

account_type をパートナー アカウントの AccountType に設定します。たとえば、リンクが広告主アカウントからデータ パートナー アカウントへのリンクである場合は、このフィールドを DATA_PARTNER に設定します。

account_id をパートナー アカウントの ID に設定します。

リクエストを作成する

パートナー リンクを作成するには、CreatePartnerLinkRequest を作成します。

  1. parent を広告主アカウントのリソース名に設定します。次の形式を使用します。

    accountTypes/{account_type}/accounts/{account}

  2. partner_link を作成した PartnerLink リソースに設定します。

  3. 認証情報が、Google 広告のクライアント センター（MCC）アカウントやディスプレイ＆ビデオ 360 のパートナー アカウントなど、広告主アカウントの親アカウントにアクセスできる Google アカウントのものである場合は、配信先とヘッダーを構成するの説明に沿って login-account ヘッダーを設定します。

さまざまなタイプの広告主アカウントでデータ パートナー アカウントへのリンクを作成する JSON リクエストの例を次に示します。

API Explorer で開く
{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

ディスプレイ＆ビデオ 360 広告主

API Explorer で開く
{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

ディスプレイ＆ビデオ 360 パートナー

API Explorer で開く
{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

リクエストを送信する

リクエストを送信し、必要に応じてリクエスト ヘッダーを含めます。owning_account にアクセスできる Google アカウントの認証情報を使用します。

リクエストが成功すると、レスポンスには、id と name が入力された作成済みの PartnerLink が含まれます。

リクエストが失敗した場合は、エラーを調べて失敗の原因を特定し、リクエストとヘッダーを更新して問題を修正してから、更新したリクエストとヘッダーを送信します。

PartnerLink を削除するには、name をリソース名に設定して DeletePartnerLinkRequest を送信します。必要に応じて、ヘッダーを設定します。

前へ
概要
次へ
パートナー リンクを取得する