Google Ads API는 Google Ads 계정을 다른 제품 계정에 연결하는 기능을 지원합니다. 이 가이드에서는 API v16 버전을 사용하여 계정을 연결하는 방법에 대해 설명합니다.
계정 연결 방법
Google Ads 계정을 다른 제품 계정에 연결할 때는 두 가지 방법으로 연결할 수 있습니다.
초대 흐름
초대 흐름은 Google Ads 계정에 대한 관리자 액세스 권한이 있지만 제품 계정은 없는 경우에 사용됩니다. 이 흐름은 다음 두 가지 시나리오에서 작동합니다.
- 두 계정을 연결하고 제품 계정의 관리자를 위한 초대를 만들려고 합니다. 제품 계정 관리자가 초대를 수락하여 계정 연결 절차를 완료합니다.
- 제품 계정 관리자가 두 계정을 연결하려고 하지만 Google Ads 계정에 대한 액세스 권한이 없습니다. 제품 계정 관리자가 초대를 만들고, 초대를 수락하고 연결 프로세스를 완료합니다.
이 시나리오에서는 다음 메서드가 사용됩니다.
| 시나리오 | 작업 | 비고 |
|---|---|---|
| 시나리오 1 | 초대장 만들기 |
ProductLinkInvitationService.CreateProductLinkInvitation 메서드를 사용하여 초대를 만듭니다.
ProductLinkInvitation의
status를
설정하면 안 됩니다.
API 호출이 성공적으로 완료되면 Google Ads API 서버에서
이 값을 REQUESTED로 설정합니다. |
| 초대 상태 검사하기 | 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 |
대기 중인 초대가 이미 존재하므로 링크를 만들 수 없습니다. |
AccountLinkService 및 MerchantCenterLinkService 변경사항
이전에 MerchantCenterLinkService 또는 AccountLinkService를 사용하여 Google Ads 계정을 다른 제품 계정에 연결한 경우 기존 애플리케이션을 위에 나열된 워크플로 중 하나로 이전해야 합니다. 다음 표는 마이그레이션 상태를 보여줍니다.
| 링크 유형 | 새 서비스에서 지원 여부 | 지원 시작 날짜: | 비고 |
|---|---|---|---|
DataPartnerIdentifier |
예 | v15 | MerchantCenterLinkService에서 이전 |
GoogleAdsIdentifier |
예 | v16 | AccountLinkService에서 이전 |
MerchantCenterIdentifier |
예 | v16 | AccountLinkService에서 이전 |
AdvertisingPartnerIdentifier |
예 | v16 | AccountLinkService에서 이전 |
ThirdPartyAppAnalyticsLinkIdentifier |
아니요 | – | AccountLinkService 계속 사용 |