필드 매핑

필드 매핑을 사용하여 파트너 링크 워크플로의 각 단계를 Google Ads API에서 데이터 관리 도구 API로 업그레이드합니다.

객체 필드 매핑

표의 매핑을 사용하여 Google Ads API의 ProductLink을 데이터 관리 도구 API의 PartnerLink에 매핑합니다.

ProductLink (Google Ads API) PartnerLink (데이터 관리 도구 API) 참고
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account 데이터 관리 도구 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을 설정하여 링크의 소유자를 나타냅니다.

데이터 관리 도구 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를 데이터 관리 도구 API의 상응하는 CreatePartnerLinkRequest로 변환하는 필드 매핑은 다음과 같습니다.

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

요청 삭제

Google Ads API의 RemoveProductLinkRequest를 데이터 관리 도구 API의 상응하는 DeletePartnerLinkRequest로 변환하는 필드 매핑은 다음과 같습니다.

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

연결 가져오기 요청 매핑

파트너 링크를 가져오는 방법은 Google Ads API와 데이터 관리 도구 API 간에 다릅니다.

Google Ads API

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

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

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

Google Ads API의 SearchGoogleAdsRequest를 데이터 관리 도구 API의 상응하는 SearchPartnerLinksRequest로 변환하는 필드 매핑은 다음과 같습니다.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (데이터 관리 도구 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를 구성하고 다양한 시나리오에 맞게 요청 헤더를 설정하는 방법을 비롯한 자세한 내용은 파트너 링크 가져오기를 참고하세요.

이전
업그레이드 단계