Menautkan YouTube

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

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

  1. Anda meminta agar video ditautkan ke akun Anda. Dalam skenario ini, Anda mengirimkan permintaan kepada kreator, yang harus disetujui oleh kreator tersebut untuk membuat tautan ke videonya. Anda dapat membatalkan permintaan yang telah diperpanjang sebelum disetujui, dan juga menghapus video tertaut setelah disetujui.
  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 yang akan menerima permintaan penautan video, dan video_id video yang ingin Anda tautkan. video_id adalah string 11 karakter yang ditemukan di URL video YouTube (misalnya, parameter v di www.youtube.com/watch?v=VIDEO_ID atau jalur di youtu.be/VIDEO_ID).
Membuat permintaan penautan Gunakan metode DataLinkService.CreateDataLink untuk membuat permintaan penautan, dengan menentukan youtube_video.channel_id dan youtube_video.video_id untuk mengidentifikasi video dan channel terkaitnya. Mulai v24, Anda juga dapat menentukan youtube_link_metadata.brand_channel_id untuk memberikan ID channel korporat YouTube yang ditautkan guna membantu kreator memahami brand Anda. status dari 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 mengkueri resource data_link dan memeriksa status-nya.
Mencabut permintaan Gunakan metode DataLinkService.UpdateDataLink untuk mencabut permintaan penautan dengan mengubah status DataLink dari REQUESTED menjadi REVOKED.
Menghapus penautan Gunakan DataLinkService.RemoveDataLink untuk menghapus video yang ditautkan.
Skenario 2 Mengambil undangan Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk mengkueri resource data_link. Filter untuk status = PENDING_APPROVAL guna menemukan permintaan penautan yang akan disetujui atau ditolak.
Menerima atau menolak permintaan penautan Gunakan metode DataLinkService.UpdateDataLink untuk memperbarui status DataLink menjadi ENABLED untuk menerima atau REJECTED untuk menolak permintaan.

Mengambil detail link

Anda dapat menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk mengkueri resource data_link. Kueri berikut mengambil detail untuk link video YouTube, termasuk ID video YouTube dan ID channel:

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'

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 Link video tidak dapat dibuat karena ID video tidak valid.
DataLinkError.INVALID_STATUS Ditampilkan saat status link data saat ini tidak valid untuk operasi yang diminta.
DataLinkError.INVALID_UPDATE_STATUS Dikeluarkan saat mencoba transisi status yang tidak didukung selama update (misalnya, berpindah langsung dari REVOKED ke ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS Terjadi jika link data untuk video sudah ada.
Sebelumnya
Menautkan akun produk
Berikutnya
Ubah status