Catatan rilis

Halaman ini menyediakan catatan rilis untuk Google Bid Manager API.

Versi API terbaru: v2

1 Oktober 2024

Perhatian: Perubahan ini akan diterapkan.

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian dimensi pelaporan Anonymous Inventory Modeling (AIM)

Dimensi FILTER_ANONYMOUS_INVENTORY_MODELING sedang dihentikan.

Membuat atau menjalankan Query resource menggunakan nilai "penghentian" di params.groupBy menampilkan error 400.

Metrik DST/ROC (Biaya Operasional Peraturan) dan Total Biaya Media yang dibuat tidak kompatibel dengan laporan YOUTUBE.

Nilai metrik berikut tidak dapat digunakan lagi dalam laporan YOUTUBE:

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

Membuat atau menjalankan Query resource Anda dengan params.type dari YOUTUBE dan nilai metrik yang relevan dalam params.metrics akan menampilkan error 400.

1 Mei 2024

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian Laporan Atribusi Jalur dan Jalur Lengkap

Laporan Atribusi Jalur dan Jalur Lengkap akan dihentikan. Mengambil atau membuat ini jenis Query dan Resource Report menghasilkan error.

Hal berikut Nilai ReportType adalah matahari terbenam:

• FULL_PATH
• PATH_ATTRIBUTION

Tujuan pathQueryOptions bidang Objek Options juga matahari terbenam.

28 Februari 2024

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian nilai metrik konversi lintas-perangkat

Konversi lintas-perangkat metrik akan dihentikan. Metrik Bid Manager API berikut nilai disertakan:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 Juli 2022

Fitur baru

Merilis Bid Manager API v2.

Membuat perubahan struktural pada API, termasuk mengupdate layanan endpoint, serta mengganti nama layanan dan metode.

Referensi Kueri dan Laporan yang diperbarui secara signifikan oleh menghapus kolom yang tidak diperlukan, mengatur ulang kolom yang ada, dan mengubah kolom jenis. Ini termasuk mengubah jenis kolom agar menggunakan objek bernama, bukan "objek bertingkat" umum definisi.

Menjalankan kueri ad-hoc wajib menggunakan metode queries.run alih-alih menjalankannya secara otomatis setelah pembuatan.

Mengganti parameter kueri queries.run asynchronous dengan synchronous.

Pengambilan laporan yang disederhanakan melalui perubahan berikut:

• Penambahan metode queries.reports.get.
• Penambahan parameter kueri orderBy ke queries.reports.list
• Pembaruan isi respons queries.run dari objek kosong menjadi instance resource Report yang dihasilkan.

Pesan error yang diperbarui yang ditampilkan oleh API menjadi lebih spesifik dan memberikan dan solusi preskriptif.

Ikuti petunjuk yang disajikan dalam Panduan Migrasi v2 untuk bermigrasi dari v1.1 ke v2.

v2

• Endpoint layanan telah diubah:

  Endpoint layanan v1	Endpoint layanan v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Layanan telah berganti nama sebagai berikut:

  Layanan v1	Layanan v2
  Kueri	kueri
  Laporan	queries.reports

• Metode telah diganti namanya sebagai berikut:

  Metode v1	Metode v2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• Metode berikut telah ditambahkan:

  Layanan	Metode
  queries.reports	dapatkan

• Metode berikut memiliki isi respons baru:

  Metode	Objek isi respons baru
  queries.run	Laporan

• Kolom berikut telah dihapus:

  Resource	Kolom
  Isi Respons queries.list	jenis
  Isi Respons queries.reports.list	jenis
  Kueri	jenis reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• Jenis objek kolom berikut telah diubah menjadi berikut:

  Resource	Kolom	Jenis Objek
  Kueri	metadata parameter jadwal	QueryMetadata Parameter QuerySchedule
  Laporan	key metadata parameter	ReportKey ReportMetadata Parameter
  RunQueryRequest	dataRange	DataRange

• Parameter kueri metode berikut telah ditambahkan:

  Metode	Parameter Kueri
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	sinkron

• Parameter kueri metode berikut telah dihapus:

  Metode	Parameter Kueri
  queries.create	asinkron
  queries.run	asinkron

• Nilai Filter berikut telah ditambahkan:

  Nilai filter
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Nilai Filter berikut telah dihapus:

  Nilai filter
  FILTER_TRUEVIEW_IAR_REGION

• Nilai Metrik berikut telah ditambahkan:

  Nilai metrik
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

Masalah umum

Tidak ada.

Rilis sebelumnya

Untuk membaca rilis API Bid Manager sebelumnya untuk versi yang dihentikan, lihat arsip catatan rilis yang diarsipkan.