YouTube 연결

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

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

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

각 시나리오에서는 다음 메서드가 사용됩니다.

시나리오 작업 비고
시나리오 1 YouTube API에서 동영상 정보 가져오기 YouTube API를 사용하여 동영상 링크 요청을 보낼 channel_id 또는 연결하려는 동영상의 video_id을 가져옵니다. video_id은 "v=" 뒤에 나오는 11자를 가져와 동영상 URL에서 가져올 수도 있습니다.
연결 요청 만들기 DataLinkService.CreateDataLink 메서드를 사용하여 링크 요청을 만듭니다. 원하는 경우 youtube_video.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를 비롯한 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가 잘못되어 동영상 링크를 만들 수 없습니다.
이전
제품 계정 연결
다음
상태 변경