Menautkan YouTube

Google Ads API mendukung penautan video YouTube ke akun Google Ads Anda. Panduan ini menjelaskan cara menggunakan API untuk menambahkan dan menghapus tautan ke akun Anda.

Menautkan video

Video dapat ditautkan ke akun Anda dengan salah satu dari dua cara, bergantung pada siapa yang memulai prosesnya, yaitu:

1. Anda meminta agar video ditautkan ke akun Anda. Dalam skenario ini, Anda mengirimkan permintaan kepada kreator, yang harus mereka setujui untuk membuat tautan ke video mereka. Anda dapat mencabut permintaan yang telah diperpanjang sebelum diterima, dan juga menghapus video tertaut setelah diterima.
2. Kreator video meminta agar videonya ditautkan ke akun Google Ads Anda. Kemudian, Anda dapat memilih untuk menerima atau menolak permintaan mereka.

Metode berikut digunakan dalam setiap skenario:

Skenario	Tindakan	Keterangan
Skenario 1	Mendapatkan informasi video dari YouTube API	Gunakan YouTube API untuk mendapatkan channel_id untuk mengirim permintaan penautan video, atau video_id dari video yang ingin Anda tautkan. video_id juga dapat diambil dari URL video dengan mengambil 11 karakter setelah "v=".
	Membuat permintaan penautan	Gunakan metode DataLinkService.CreateDataLink untuk membuat permintaan penautan. Anda dapat secara opsional menentukan youtube_video.channel_id untuk mengidentifikasi channel yang terkait dengan video secara eksplisit, dan youtube_link_metadata.brand_channel_id untuk menentukan ID channel merek YouTube tertaut guna membantu kreator memahami merek Anda. status DataLink tidak boleh ditetapkan; server Google Ads API akan menetapkannya ke REQUESTED setelah panggilan API berhasil diselesaikan.
	Memeriksa status permintaan	Gunakan GoogleAdsService.SearchStream atau GoogleAdsService.Search untuk membuat kueri resource data_link dan memeriksa status-nya.
	Mencabut permintaan	Gunakan metode DataLinkService.UpdateDataLink untuk mencabut permintaan penautan dengan mengubah status dari DataLink dari REQUESTED menjadi REVOKED.
	Menghapus tautan	Gunakan DataLinkService.RemoveDataLink untuk menghapus video tertaut.
Skenario 2	Mengambil undangan	Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource data_link. Filter untuk status = PENDING_APPROVAL untuk menemukan permintaan penautan yang akan diterima atau ditolak.
	Menerima atau menolak permintaan penautan	Gunakan metode DataLinkService.UpdateDataLink untuk memperbarui status dari DataLink menjadi ENABLED untuk menerima atau REJECTED untuk menolak permintaan.

Mengambil detail tautan

Anda dapat menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource data_link. Kueri berikut mengambil detail untuk tautan video YouTube, termasuk ID channel YouTube dan ID channel merek YouTube tertaut.

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'

Error umum berikut dapat ditampilkan dalam alur kerja ini:

Kode error	Penjelasan
DataLinkError.PERMISSION_DENIED	Pelanggan tidak memiliki izin untuk melakukan tindakan ini.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Tautan video tidak dapat dibuat karena ID video tidak valid.