필드 매핑

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

  • 객체 필드 매핑에는 파트너 연결 객체를 나타내는 리소스 의 필드 매핑이 포함되어 있습니다.
  • 연결 관리 요청 매핑에는 파트너 연결을 만들고 삭제하는 요청의 필드 매핑이 포함되어 있습니다.
  • 연결 검색 요청 매핑에는 파트너 연결을 검색하기 위한 필드 매핑이 포함되어 있습니다.

객체 필드 매핑

표의 매핑을 사용하여 ProductLink를 Google Ads API에서 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를 만들 때 customer_id의 CreateProductLinkRequest를 설정하여 연결의 소유자를 나타냅니다.

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

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

type owning_account.account_type

리소스 이름

Data Manager 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를 상응하는 CreatePartnerLinkRequest Data Manager API로 변환하는 필드 매핑입니다.

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

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

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

SearchPartnerLinkRequest를 보냅니다. 선택적 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 적용되지 않습니다.

파트너 연결 검색을 비롯한 자세한 내용은 filter 요청의 SearchPartnerLinksRequest를 구성하고 다양한 시나리오에 대한 요청 헤더를 설정하는 방법을 참고하세요.

이전
업그레이드 단계