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가 잘못되어 동영상 링크를 만들 수 없습니다. |