Pertanyaan Umum (FAQ)

Umum

Apa versi API terbaru?

Versi API terbaru yang ditangani dokumen ini adalah v4.

Dapatkah saya mengambil data performa menggunakan API ini?

Tidak. Gunakan Bid Manager API untuk membuat, mengambil, dan menjalankan laporan offline Display & Video 360.

Menggunakan API

URL apa yang saya gunakan untuk mengakses API?

https://displayvideo.googleapis.com

Metode autentikasi apa yang didukung?

OAuth 2.0 adalah satu-satunya metode autentikasi yang didukung.

Permintaan Display & Video 360 API harus diotorisasi untuk cakupan berikut:

  • https://www.googleapis.com/auth/display-video

Permintaan ke layanan users juga harus diberi otorisasi untuk cakupan tambahan berikut:

  • https://www.googleapis.com/auth/display-video-user-management

Saya ingin menulis kode. Di mana saya dapat menemukan library klien?

Lihat panduan library klien.

Bagaimana jika saya tidak ingin menggunakan library klien?

Sebaiknya gunakan salah satu library klien kami, tetapi Anda juga dapat berinteraksi dengan Display & Video 360 API menggunakan permintaan HTTP langsung.

Beberapa metode yang lebih rumit, seperti advertisers.assets.upload dan media.upload, lebih sulit diterjemahkan langsung ke permintaan HTTP. Lihat contoh permintaan HTTP ke metode ini menggunakan cURL di panduan Materi Iklan dan Bidding Kustom.

Izin Display & Video 360 apa yang saya perlukan?

Untuk menggunakan Display & Video 360 API, Akun Google yang melakukan autentikasi harus merupakan pengguna Display & Video 360 dengan akses ke partner atau pengiklan yang relevan.

Pengguna Display & Video 360 harus memiliki salah satu peran pengguna berikut untuk partner atau pengiklan yang relevan agar dapat melakukan tindakan berikut:

  • Hanya baca: Mengambil resource menggunakan panggilan get atau list, tidak termasuk resource user.
  • Standar: Mengambil, membuat, dan memperbarui resource. Ambil resource user dengan izin ke partner atau pengiklan yang sama.
  • Admin: Mengambil, membuat, dan memperbarui resource. Mengambil, membuat, dan memberikan akses ke resource user untuk partner atau pengiklan yang Anda kelola.

Bagaimana cara memperbarui referensi YouTube & Partners menggunakan API?

Display & Video 360 API tidak mendukung pembuatan atau pembaruan resource YouTube & Partner. Buat atau perbarui aset YouTube & Partner secara massal dengan mengupload File Data Terstruktur (SDF) di antarmuka Display & Video 360. Untuk mengetahui detail selengkapnya tentang cara menggunakan upload SDF, baca halaman panduan tentang referensi YouTube & Partner.

Bagaimana cara menargetkan lokasi geografis?

Penargetan geografis dapat ditetapkan ke item baris menggunakan jenis penargetan berikut:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Ambil ID opsi penargetan untuk tiga jenis penargetan pertama menggunakan targetingTypes.targetingOptions.search. Ambil dan kelola resource daftar lokasi menggunakan layanan advertisers.locationLists.

Selain itu, Anda juga dapat mem-build ID opsi penargetan TARGETING_TYPE_POI untuk menargetkan radius kedekatan secara langsung di sekitar koordinat lintang-bujur tertentu.

Saya melihat bahwa saya dapat mendownload File Data Terstruktur (SDF) menggunakan API, tetapi bagaimana cara menguploadnya?

Display & Video 360 API tidak mendukung upload SDF. Sebaiknya kelola resource melalui metode CREATE, PATCH, dan DELETE yang disediakan oleh API. Jika Anda masih ingin mengelola resource menggunakan SDF, file tersebut dapat diperbarui di antarmuka Display & Video 360.

Dukungan

Apakah API memiliki masalah atau batasan umum?

Ada batasan jumlah permintaan yang dapat dilakukan project Anda per detik, yang diuraikan dalam panduan batas penggunaan kami.