제품 계정 연결

Google Ads API는 Google Ads 계정을 다른 제품 계정에 연결하는 것을 지원합니다. 이 가이드에서는 API를 사용하여 계정을 연결하는 방법을 설명합니다.

Google Ads 계정을 다른 제품 계정에 연결할 때 연결이 이루어지는 방법에는 두 가지가 있습니다.

초대 흐름

초대 흐름은 Google Ads 계정에 대한 관리자 액세스 권한은 있지만 제품 계정에 대한 액세스 권한은 없는 경우에 사용됩니다. 이 흐름은 두 가지 시나리오에서 작동합니다.

  1. 두 계정을 연결하고 제품 계정 관리자를 위한 초대를 만들려고 합니다. 제품 계정 관리자가 초대를 수락하여 계정 연결 프로세스를 완료합니다.
  2. 제품 계정 관리자가 두 계정을 연결하려고 하지만 Google Ads 계정에 액세스할 수 없습니다. 제품 계정 관리자가 초대를 만들고 사용자가 초대를 수락하여 연결 프로세스를 완료합니다.

이 시나리오에서는 다음 메서드가 사용됩니다.

시나리오 작업 비고
시나리오 1 초대 만들기 ProductLinkInvitationService.CreateProductLinkInvitation 메서드를 사용하여 초대를 만듭니다. status ProductLinkInvitation의 REQUESTED는 설정해서는 안 됩니다. Google Ads API 서버 는 API 호출이 성공적으로 완료되면 이를 설정합니다.
초대 상태 검사 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 을 사용하여 product_link_invitation 리소스를 쿼리하고 상태를 검사합니다.
시나리오 2 초대 검색 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 을 사용하여 product_link_invitation 리소스를 쿼리합니다. status = PENDING_APPROVAL을 필터링하여 대기 중인 초대를 수락하거나 거부합니다.
초대 수락 또는 거부 ProductLinkInvitationService.UpdateProductLinkInvitation 메서드를 사용하여 ProductLinkInvitation의 상태를 ACCEPTED 또는 REJECTED로 업데이트합니다.
초대 취소 ProductLinkInvitationService.RemoveProductLinkInvitation 메서드를 사용하여 기존 ProductLinkInvitation을 취소합니다.

이 워크플로에서는 다음과 같은 일반적인 오류가 발생할 수 있습니다.

오류 코드 설명
ProductLinkInvitationError.PERMISSION_DENIED 고객에게 이 작업을 수행할 권한이 없습니다.
ProductLinkError.NO_INVITATION_REQUIRED 사용자가 이미 초대된 계정에 대한 관리자 액세스 권한을 보유하고 있으므로 초대를 만들 수 없습니다. 사용자는 ProductLinkService를 사용하여 활성 링크를 직접 만들어야 합니다.

직접 연결 흐름

직접 연결 흐름은 Google Ads 계정과 제품 계정 모두에 대한 관리자 액세스 권한이 있는 경우에 사용됩니다. 이 경우 초대를 보내는 대신 Google Ads 계정을 제품 계정에 직접 연결합니다.

이 시나리오에서는 다음 메서드가 사용됩니다.

작업 비고
활성 링크 만들기 ProductLinkService.createProductLink를 사용하여 ProductLink를 만듭니다.
활성 링크 사용 중지 ProductLinkService.removeProductLink를 사용하여 활성 ProductLink를 삭제합니다.
활성 링크 검색 GoogleAdsService.Search 또는 GoogleAdsService.SearchStream 을 사용하여 product_link 리소스를 쿼리합니다.

이 워크플로에서는 다음과 같은 일반적인 오류가 발생할 수 있습니다.

오류 코드 설명
ProductLinkError.CREATION_NOT_PERMITTED 직접 연결 흐름을 사용하여 계정 연결을 시도했지만 권한이 없어 지원되지 않습니다. 사용자는 ProductLinkInvitationService 를 사용하여 초대 흐름을 대신 실행해야 합니다.
ProductLinkError.INVITATION_EXISTS 대기 중인 초대가 이미 있으므로 링크를 만들 수 없습니다.

GAQL 쿼리를 사용하여 Google Ads 계정과 연결된 모든 제품 링크를 검색할 수 있습니다. product_link 리소스에 대한

    SELECT
      product_link.product_link_id,
      product_link.type
    FROM product_link

product_link.type 필드는 연결된 제품 또는 서비스의 유형을 나타냅니다. type에 따라 product_link 리소스 내의 다른 필드가 채워져 링크에 대한 자세한 정보를 제공합니다. 예를 들어 유형이 THIRD_PARTY_APP_ANALYTICS인 경우 third_party_app_analytics 필드에 애널리틱스 제공업체에 대한 정보가 포함됩니다.

이를 통해 Google Play, 데이터 파트너 또는 서드 파티 앱 분석 플랫폼과 같이 Google Ads 계정에 직접 연결된 외부 서비스 및 애플리케이션 목록을 가져올 수 있습니다.

AccountLinkService 변경사항

AccountLinkService를 사용하여 Google Ads 계정을 다른 제품 계정에 연결하는 경우 기존 애플리케이션을 앞에서 설명한 워크플로 중 하나로 이전해야 합니다. 다음 링크 유형의 경우 AccountLinkService에서 이전하고 ProductLinkService를 사용하세요.

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

ThirdPartyAppAnalyticsLinkIdentifier의 경우 AccountLinkService를 계속 사용하세요.

이전
사용자 액세스 초대 관리
다음
YouTube 연결