Google Ads API는 YouTube 동영상을 Google Ads 계정에 연결하는 기능을 지원합니다. 이 가이드에서는 API를 사용하여 계정에 대한 링크를 추가하고 삭제하는 방법을 설명합니다.
동영상 연결
동영상은 절차를 시작한 사람에 따라 다음 두 가지 방법 중 하나로 계정에 연결할 수 있습니다.
- 동영상을 내 계정에 연결해 달라고 요청합니다. 이 시나리오에서는 크리에이터에게 요청을 보내고 크리에이터가 동영상 연결을 설정하려면 이 요청을 수락해야 합니다. 수락되기 전에 연장된 요청은 취소할 수 있으며, 수락된 후에는 연결된 동영상을 삭제할 수도 있습니다.
- 동영상의 크리에이터가 동영상을 Google Ads 계정에 연결해 달라고 요청합니다. 그런 다음 요청을 수락하거나 거부할 수 있습니다.
각 시나리오에서는 다음 메서드가 사용됩니다.
| 시나리오 | 작업 | 비고 |
|---|---|---|
| 시나리오 1 | YouTube API에서 동영상 정보 가져오기 | YouTube API를 사용하여 동영상 링크 요청을 보낼 channel_id 또는 연결하려는 동영상의 video_id를 가져옵니다. video_id는 "v=" 뒤의 11자를 가져와 동영상 URL에서 가져올 수도 있습니다. |
| 연결 요청 만들기 |
DataLinkService.CreateDataLink 메서드를 사용하여 링크 요청을 만듭니다. DataLink의 status는 설정하면 안 됩니다. Google Ads API 서버는 API 호출이 완료되면 이를 REQUESTED로 설정합니다. |
|
| 요청 상태 검사 | GoogleAdsService.SearchStream 또는 GoogleAdsService.Search를 사용하여 data_link 리소스를 쿼리하고
status를 검사합니다. |
|
| 요청 취소 |
DataLinkService.UpdateDataLink 메서드를 사용하여
DataLink의 status를 REQUESTED에서 REVOKED로 변경하여 링크 요청을 취소합니다. |
|
| 링크 삭제 |
DataLinkService.RemoveDataLink 아이콘을 사용하여 연결된 동영상을 삭제합니다. |
|
| 시나리오 2 | 초대 수신 | GoogleAdsService.Search 또는 GoogleAdsService.SearchStream를 사용하여 data_link 리소스를 쿼리합니다.
status = PENDING_APPROVAL를 필터링하여 수락하거나 거부할 연결 요청을 찾습니다. |
| 연결 요청 수락 또는 거부하기 |
DataLinkService.UpdateDataLink 메서드를 사용하여 DataLink의 상태를 ENABLED로 업데이트하여 요청을 수락하거나 REJECTED로 업데이트하여 요청을 거부합니다. |
이 워크플로에서 다음과 같은 일반적인 오류가 발생할 수 있습니다.
| 오류 코드 | 설명 |
|---|---|
DataLinkError.PERMISSION_DENIED |
고객에게 이 작업을 수행할 권한이 없습니다. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
동영상 ID가 잘못되어 동영상 링크를 만들 수 없습니다. |