YouTube 연결

Google Ads API는 YouTube 동영상을 Google Ads 계정에 연결하는 기능을 지원합니다. 이 가이드에서는 API를 사용하여 계정에 연결을 추가하고 삭제하는 방법을 설명합니다.

동영상은 프로세스를 시작하는 사용자에 따라 다음 두 가지 방법 중 하나로 계정에 연결할 수 있습니다.

  1. 계정에 동영상을 연결하도록 요청합니다. 이 시나리오에서는 크리에이터에게 요청을 보내고 크리에이터가 요청을 수락해야 동영상에 연결이 설정됩니다. 수락되기 전에 연장된 요청을 취소할 수 있으며 수락된 후에는 연결된 동영상을 삭제할 수도 있습니다.
  2. 동영상 크리에이터가 동영상을 Google Ads 계정에 연결하도록 요청합니다. 그러면 요청을 수락하거나 거부할 수 있습니다.

각 시나리오에서 사용되는 메서드는 다음과 같습니다.

시나리오 작업 비고
시나리오 1 YouTube API에서 동영상 정보 가져오기 YouTube API를 사용하여 동영상 연결 요청을 보낼 channel_id와 연결할 동영상의 video_id를 가져옵니다. video_id는 YouTube 동영상 URL에서 찾을 수 있는 11자리 문자열입니다 (예: www.youtube.com/watch?v=VIDEO_ID의 v 매개변수 또는 youtu.be/VIDEO_ID의 경로).
연결 요청 만들기 DataLinkService.CreateDataLink 메서드를 사용하여 연결 요청을 만들고 동영상과 연결된 채널을 식별하기 위해 youtube_video.channel_id와 youtube_video.video_id 모두를 지정합니다. v24부터는 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 및 채널 ID를 비롯한 YouTube 동영상 연결의 세부정보를 검색합니다.

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

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

오류 코드 설명
DataLinkError.PERMISSION_DENIED 고객에게 이 작업을 수행할 권한이 없습니다.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID 동영상 ID가 잘못되어 동영상 연결을 만들 수 없습니다.
DataLinkError.INVALID_STATUS 요청된 작업에 데이터 연결의 현재 상태가 잘못된 경우 발생합니다.
DataLinkError.INVALID_UPDATE_STATUS 업데이트 중에 지원되지 않는 상태 전환을 시도할 때 발생합니다 (예: REVOKED에서 ENABLED로 직접 이동).
MutateError.RESOURCE_ALREADY_EXISTS 동영상의 데이터 연결이 이미 있는 경우 발생합니다.
이전
제품 계정 연결
다음
상태 변경