필드 매핑

필드 매핑을 사용하여 파트너 연결 워크플로의 각 단계를 Google Ads API에서 Data Manager API로 업그레이드합니다.

인증

Data Manager API에는 Google Ads API와 다른 범위의 사용자 인증 정보가 필요합니다. 파트너 링크 관리를 위한 Data Manager API 범위가 포함된 새 사용자 인증 정보를 생성해야 합니다.

객체 필드 매핑

표의 매핑을 사용하여 Google Ads API의 ProductLink를 Data Manager API의 PartnerLink에 매핑합니다.

ProductLink (Google Ads API) PartnerLink (Data Manager API) 참고
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Data Manager API에는 연결된 계정 유형별로 별도의 필드가 없습니다. 모든 계정 유형에서 partner_account 필드를 ProductAccount로 설정하고 account_type 및 account_id를 설정하여 연결된 계정을 식별합니다.
product_link_id partner_link_id
resource_name name

Google Ads API에서 ProductLink의 resource_name에 대한 customer_id는 기존 연결을 소유한 계정을 나타냅니다. ProductLink을 만들 때 CreateProductLinkRequest의 customer_id를 설정하여 링크 소유자를 나타냅니다.

Data Manager API에서 owning_account의 accountType와 accountId의 조합은 기존 연결을 소유한 계정을 나타냅니다. PartnerLink을 만들 때 name를 소유자의 리소스 이름으로 설정하여 링크 소유자를 나타냅니다.

자세한 내용은 리소스 이름 및 요청 만들기를 참조하세요.

type owning_account.account_type

리소스 이름

데이터 관리 도구 API는 Google Ads API와 다른 리소스 이름 형식을 사용합니다.

Google Ads API

Google Ads API에서 ProductLink 리소스 이름은 다음 형식을 사용합니다.

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Data Manager API에서 PartnerLink 리소스 이름은 다음 형식을 사용합니다.

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

연결 관리 요청 매핑

이 섹션의 요청 매핑을 사용하여 파트너 링크를 생성, 삭제, 검색하는 요청을 변환합니다.

요청 만들기

다음은 Google Ads API의 CreateProductLinkRequest를 Data Manager API의 동등한 CreatePartnerLinkRequest로 변환하는 필드 매핑입니다.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) 참고
customer_id parent 소유 광고주 계정의 리소스 이름으로 설정합니다.
product_link partner_link PartnerLink 리소스로 설정합니다. 객체 필드 매핑을 참조하세요.

요청 삭제

다음은 Google Ads API의 RemoveProductLinkRequest를 Data Manager API의 동등한 DeletePartnerLinkRequest로 변환하는 필드 매핑입니다.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) 참고
customer_id 적용되지 않습니다. name 필드는 소유 계정과 파트너 계정을 캡슐화하므로 이 추가 필드는 필요하지 않습니다.
resource_name name 삭제하려는 PartnerLink의 리소스 이름으로 설정합니다.
validate_only 적용되지 않습니다.

링크 검색 요청 매핑

파트너 링크를 가져오는 방법은 Google Ads API와 Data Manager API 간에 다릅니다.

Google Ads API

query가 포함된 SearchGoogleAdsRequest를 전송합니다. 쿼리의 선택적 WHERE 절은 반환할 리소스를 정의합니다. 쿼리의 SELECT 절은 반환된 부분 리소스에 채울 필드를 정의합니다.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

SearchPartnerLinksRequest을 보냅니다. 선택사항인 filter 요청 필드는 반환할 리소스를 정의합니다. 응답에는 모든 필드가 채워진 전체 리소스가 포함됩니다.

다음은 Google Ads API의 SearchGoogleAdsRequest를 Data Manager API의 동등한 SearchPartnerLinksRequest로 변환하는 필드 매핑입니다.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) 참고
customer_id parent 검색할 계정의 리소스 이름으로 설정합니다.
page_size page_size
page_token page_token
query filter filter를 설정하여 반환할 리소스를 정의합니다. Data Manager API는 전체 리소스를 반환하므로 SELECT 절과 동일한 항목이 없습니다.
search_settings 적용되지 않습니다.
validate_only 적용되지 않습니다.

SearchPartnerLinksRequest 요청의 filter를 구성하고 다양한 시나리오에 대한 요청 헤더를 설정하는 방법을 비롯한 자세한 내용은 파트너 링크 가져오기를 참조하세요.

이전
업그레이드 단계