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

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 広告の管理アカウントやディスプレイ＆ビデオ 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 アカウントの認証情報を使用します。

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

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

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

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