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

PartnerLink リソースを作成または削除する方法は次のとおりです。Data Manager API では、次のアカウントの種類でパートナー リンクを作成できます。

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

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 で開く
{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

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

API Explorer で開く
{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

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

API Explorer で開く
{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

API Explorer で開く
{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

リクエストを送信する

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

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

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

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

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