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 브랜드 채널의 ID를 제공하여 크리에이터가 브랜드를 이해할 수 있도록 youtube_link_metadata.brand_channel_id를 지정할 수도 있습니다. 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(거부)로 업데이트하여 요청을 수락하거나 거부합니다.

링크 세부정보 가져오기

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 동영상의 데이터 링크가 이미 있는 경우 발생합니다.
이전
제품 계정 연결
다음
상태 변경