Pertanyaan Umum (FAQ)

Umum

Apa versi terbaru API?

Versi terbaru API yang ditangani dokumen ini adalah v3.

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 otentikasi apa yang didukung?

OAuth 2.0 adalah satu-satunya metode autentikasi yang didukung.

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

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

Permintaan ke layanan users juga harus diizinkan 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 kompleks, seperti advertisers.assets.upload dan media.upload, lebih sulit untuk diterjemahkan langsung ke permintaan HTTP. Lihat contoh permintaan HTTP ke metode ini menggunakan cURL di panduan Materi Iklan dan Bidding Kustom kami.

Izin Display & Video 360 apa yang saya perlukan?

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

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

  • Hanya baca: Ambil resource menggunakan panggilan get atau list, tidak termasuk resource user.
  • Standard: Mengambil, membuat, dan memperbarui resource. Mengambil resource user dengan izin untuk partner atau pengiklan yang sama.
  • Admin: Mengambil, membuat, dan memperbarui fasilitas. Ambil, buat, dan berikan 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 referensi YouTube & Partners 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.

Bagaimanakah 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 membuat ID opsi penargetan TARGETING_TYPE_POI untuk langsung menargetkan radius kedekatan di sekitar koordinat garis lintang dan garis 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 dibuat oleh project Anda per detik, yang diuraikan dalam panduan batas penggunaan kami.