파트너 링크 만들기 또는 삭제

PartnerLink 리소스를 만들거나 삭제하는 방법은 다음과 같습니다. Data Manager API는 다음 계정 유형의 파트너 연결 생성을 지원합니다.

  • Google Ads 계정
  • Display & Video 360 파트너 또는 Display & Video 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 Ads 관리자 계정 또는 Display & Video 360 파트너 계정과 같이 광고주 계정의 상위 계정에 액세스할 수 있는 Google 계정의 사용자 인증 정보인 경우 대상 및 헤더 구성에 설명된 대로 login-account 헤더를 설정합니다.

다음은 다양한 유형의 광고주 계정에서 데이터 파트너 계정에 연결하기 위한 JSON 형식의 샘플 요청입니다.

API 탐색기에서 열기 
{
    "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"
        }
    }
}

DV360 광고주

API 탐색기에서 열기 
{
    "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"
        }
    }
}

DV360 파트너

API 탐색기에서 열기 
{
    "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를 삭제하려면 name이 리소스 이름으로 설정된 DeletePartnerLinkRequest을 보냅니다. 필요한 경우 헤더를 설정합니다.

이전
개요
다음
파트너 링크 가져오기