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 메서드를 사용하여 연결 요청을 만듭니다. 선택적으로
youtube_video.channel_id을 지정하여 동영상과 연결된 채널을 명시적으로 식별하고 youtube_link_metadata.brand_channel_id
을 지정하여 연결된 YouTube 브랜드 채널의 ID를 지정하여 크리에이터가 브랜드를 이해하도록 도울 수 있습니다.
status
의 DataLink는 설정해서는 안 됩니다. 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(거부)로 업데이트합니다. |
연결 세부정보 검색
GoogleAdsService.Search
또는
GoogleAdsService.SearchStream
을 사용하여 data_link 리소스를 쿼리할 수 있습니다.
다음 쿼리는 YouTube 채널 ID 및 연결된 YouTube 브랜드 채널 ID를 비롯한 YouTube 동영상 연결의 세부정보를 검색합니다.
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
이 워크플로에서는 다음과 같은 일반적인 오류가 발생할 수 있습니다.
| 오류 코드 | 설명 |
|---|---|
DataLinkError.PERMISSION_DENIED |
고객에게 이 작업을 수행할 권한이 없습니다. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
동영상 ID가 잘못되어 동영상 연결을 만들 수 없습니다. |