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

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를 전송합니다. 필요한 경우 헤더를 설정합니다.

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