Catatan rilis

Halaman ini menyediakan catatan rilis untuk Google Bid Manager API.

Versi API terbaru: v2

1 Maret 2025

Fitur baru

Masalah umum

Menghentikan laporan ketersediaan inventaris TrueView YouTube dan dimensi terkait seperti yang diumumkan sebelumnya di pusat bantuan Display & Video 360.

v2

• Nilai enum berikut tidak digunakan lagi:

  Enum	Nilai
  ReportType	INVENTORY_AVAILABILITY

• Filter berikut tidak digunakan lagi:

  Nilai filter

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME FILTER_TRUEVIEW_IAR_REMARKETING_LIST FILTER_TRUEVIEW_IAR_TIME_OF_DAY FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO FILTER_TRUEVIEW_IAR_ZIPCODE FILTER_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• Metrik berikut tidak digunakan lagi:

  Nilai metrik
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 November 2024

Fitur baru

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID diluncurkan. Hal ini memungkinkan penyertaan data dengan akurasi yang lebih rendah untuk metrik dengan awalan berikut:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

Salah satu metrik yang relevan harus disertakan saat menggunakan filter ini.

Setelah diluncurkan, kueri yang tidak menyertakan filter ini akan ditetapkan secara default ke perilaku default sebelumnya yang hanya menyertakan data dengan akurasi tinggi. Pada dan setelah 4 Februari 2025, kueri yang tidak menyertakan filter ini akan secara default menyertakan data dengan tingkat keyakinan yang lebih rendah.

v2

• Filter berikut telah ditambahkan:

  Jenis Filter	Nilai yang tersedia
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Menyertakan data dengan tingkat keyakinan yang lebih rendah. (Default setelah 4 Februari 2025) 1: Hanya sertakan data dengan tingkat keyakinan tinggi. (Default sebelum 4 Februari 2025)

1 Oktober 2024

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian dimensi pelaporan Model Inventaris Anonim (AIM)

Dimensi FILTER_ANONYMOUS_INVENTORY_MODELING adalah sunset.

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

Metrik DST/ROC (Regulatory Operating Costs) dan Total Media Cost dibuat tidak kompatibel dengan laporan YOUTUBE.

Nilai metrik berikut tidak dapat lagi digunakan 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 resource Query dengan params.type dari YOUTUBE dan nilai metrik yang relevan di params.metrics akan menampilkan error 400.

1 Mei 2024

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian Laporan Atribusi Jalur dan Jalur Lengkap

Laporan Jalur Lengkap dan Atribusi Jalur tidak digunakan lagi. Mengambil atau membuat jenis resource Query dan Report ini akan menghasilkan error.

Nilai ReportType berikut tidak digunakan lagi:

• FULL_PATH
• PATH_ATTRIBUTION

Kolom pathQueryOptions dari objek Options juga dihentikan.

28 Februari 2024

Fitur baru

Tidak ada.

Masalah umum

v2

Penghentian nilai metrik konversi lintas-perangkat

Metrik konversi lintas-perangkat tidak digunakan lagi. Nilai metrik Bid Manager API berikut 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.

Melakukan perubahan struktural pada API, termasuk memperbarui endpoint layanan dan mengganti nama layanan dan metode.

Memperbarui resource Kueri dan Laporan secara signifikan dengan menghapus kolom yang tidak perlu, mengatur ulang kolom yang ada, dan mengubah jenis kolom. Hal ini mencakup perubahan jenis kolom untuk menggunakan objek bernama, bukan definisi "objek bertingkat" umum.

Memerlukan kueri ad-hoc yang berjalan menggunakan metode queries.run, bukan 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 solusi yang lebih 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 diganti namanya 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	get

• 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 seperti berikut:

  Resource	Kolom	Jenis Objek
  Kueri	metadata params schedule	QueryMetadata Parameter QuerySchedule
  Laporan	key metadata params	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 Bid Manager API sebelumnya untuk versi yang dihentikan, lihat catatan rilis yang diarsipkan.