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.
Menautkan video
Video dapat ditautkan ke akun Anda dengan salah satu dari dua cara, bergantung pada siapa yang memulai prosesnya, yaitu:
- Anda meminta agar video ditautkan ke akun Anda. Dalam skenario ini, Anda mengirim permintaan kepada kreator, yang harus mereka setujui untuk membuat penautan ke video mereka. Anda dapat mencabut permintaan yang telah diperpanjang sebelum disetujui, dan juga menghapus video tertaut setelah disetujui.
- Kreator video meminta agar videonya ditautkan ke akun Google Ads Anda. Kemudian, Anda dapat memilih untuk menerima atau menolak permintaannya.
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, atau video_id
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. 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 membuat kueri resource data_link dan memeriksa
status-nya. |
|
| Membatalkan permintaan | Gunakan metode
DataLinkService.UpdateDataLink
untuk mencabut permintaan penautan dengan mengubah status dari
DataLink dari REQUESTED menjadi REVOKED. |
|
| Menghapus link | Gunakan
DataLinkService.RemoveDataLink untuk menghapus video yang ditautkan. |
|
| Skenario 2 | Mengambil undangan | Gunakan GoogleAdsService.Search
atau GoogleAdsService.SearchStream
untuk membuat kueri resource data_link. Filter untuk
status = PENDING_APPROVAL guna menemukan permintaan penautan
yang akan diterima atau ditolak. |
| Menerima atau menolak permintaan penautan | Gunakan metode
DataLinkService.UpdateDataLink untuk memperbarui status
DataLink
menjadi ENABLED untuk menerima atau REJECTED untuk menolak
permintaan. |
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. |