Catatan rilis Merchant Accounts API

Minggu 29 Juni 2026

  • Peluncuran filter access yang digunakan di endpoint daftar akun. Fitur ini memungkinkan Anda memfilter akun berdasarkan tingkat akses, dengan kemungkinan nilai DIRECT, INDIRECT, dan ALL. Perilaku default adalah menampilkan semua akun yang dapat Anda akses. Untuk mengetahui informasi selengkapnya, lihat Memfilter akun yang dapat Anda akses.

Minggu 20 April 2026

  • Menambahkan youtube-affiliate ke daftar nama program yang tersedia untuk accounts.programs deskripsi resource.
  • Mengaktifkan API program untuk Afiliasi YouTube Shopping. Tersedia untuk penguji tepercaya.

Minggu 6 April 2026

  • Menambahkan status WAITING ke Status Persetujuan. Untuk Layanan Perbandingan Belanja (CSS), WAITING adalah status transisi antara PENDING dan ESTABLISHED. Digunakan saat CSS asli memerlukan waktu untuk melakukan pembersihan yang diperlukan sebelum akun sepenuhnya ditransfer ke CSS baru.

Minggu 16 Maret 2026

  • Meluncurkan metode CreateTestAccount di Accounts API. Metode ini memungkinkan developer membuat akun pengujian khusus secara terprogram yang beroperasi di lingkungan sandbox terisolasi, sehingga menyediakan ruang yang aman untuk mengembangkan dan menguji integrasi.

Minggu 17 November 2025

  • CreateAndConfigureAccountRequest kini menawarkan layanan baru yang dapat dikonfigurasi selama penyiapan akun. Tepat satu dari AccountAggregation, AccountManagement, dan ComparisonShopping harus ditentukan. Selain itu, Anda dapat menentukan jumlah layanan ProductsManagement dan CampaignsManagement yang tidak terbatas. Namun, tidak boleh ada dua layanan yang memiliki ID akun eksternal dan penyedia yang sama.

  • Metode AccountsService.CreateAndConfigure kini menyediakan setelan untuk mengontrol apakah email verifikasi harus dikirim atau tidak.

  • CreateAndConfigureAccountRequest.AddAccountService kini memiliki kolom external_account_id (kolom ini sudah ada di resource AccountService) . Kolom ini dapat ditentukan bersama dengan layanan CampaignsManagement dan ProductsManagement.

  • Menambahkan layanan ComparisonShopping ke resource AccountService. Lihat https://support.google.com/merchants/answer/12653197 untuk mengetahui detail selengkapnya.

  • Anda kini dapat menetapkan alias untuk hubungan selama pembuatan akun menggunakan kolom setAlias di CreateAndConfigureAccountRequest.

  • Menambahkan metode VerifySelf ke UserService yang memungkinkan pembaruan status dari PENDING ke VERIFIED untuk resource User yang mewakili pengguna yang melakukan panggilan.

  • Meluncurkan kolom radius_area baru di payload Region Regions API yang akan memungkinkan penjual membuat wilayah menggunakan area radius.

Minggu 10 November 2025

  • Memublikasikan versi v1alpha untuk Services API.
  • Meluncurkan kolom product_filters baru di payload CampaignManagement Services API yang akan memungkinkan penjual hanya membagikan sebagian feed mereka ke akun Google Ads, berdasarkan beberapa pemfilteran bersyarat pada atribut produk penjual. Fitur ini hanya dapat diakses oleh sejumlah penjual tertentu yang diizinkan.

Minggu 25 Agustus 2025

  • Metode batch baru ditambahkan ke Regions API:
    • BatchCreateRegions: Memungkinkan pembuatan beberapa wilayah dalam satu permintaan.
    • BatchUpdateRegions: Memungkinkan pembaruan beberapa wilayah dalam satu permintaan.
    • BatchDeleteRegions: Memberikan kemampuan untuk menghapus beberapa wilayah berdasarkan nama dalam satu permintaan.

Minggu 1 Juli 2025

  • Peluncuran resource CheckoutSettings yang memungkinkan pengguna API membuat, memperbarui, menghapus, dan mendapatkan checkoutSettings.

Minggu 26 Mei 2025

  • Anda kini dapat memfilter akun berdasarkan capabilities. Saat ini, satu-satunya nilai yang mungkin adalah CAN_UPLOAD_PRODUCTS. Filter ini memungkinkan Anda mengambil akun yang dapat mengupload produk. Artinya, klausa berikut kini dapat digunakan di tingkat akun:

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Untuk mengetahui informasi selengkapnya, lihat panduan pemfilteran.

  • Peluncuran hak akses hanya baca. Pengguna dengan hak akses hanya baca dapat melihat data penjual, tetapi tidak dapat mengubahnya.

Minggu 19 Mei 2025

  • Memperbarui dokumentasi untuk program API, menghapus pernyataan yang salah bahwa metode Enable/Disable hanya dapat digunakan oleh pengguna admin.

Minggu 12 Mei 2025

  • Peluncuran resource Kebijakan Pengembalian Online yang memungkinkan pengguna API membuat, memperbarui, dan menghapus kebijakan pengembalian.
  • Peluncuran resource OmnichannelSettingsService dan OmnichannelSetting yang memungkinkan pengguna API mengelola pengalaman omnichannel mereka.
  • Peluncuran resource LfpProvidersService dan LfpProvider yang memungkinkan pengguna API mengelola hubungan Kemitraan Feed Lokal mereka.
  • Peluncuran resource GbpAccountsService dan GbpAccount yang memungkinkan pengguna API mengelola Google Profil Bisnis mereka.
  • Meluncurkan jenis layanan LocalListingManagement di AccountService, yang menautkan grup bisnis yang digunakan untuk Iklan Inventaris Lokal atau Listingan Lokal Gratis.

Minggu 28 April 2025

  • Peluncuran resource AccountService dan AccountRelationship yang memungkinkan pengguna API mengelola hubungan dan menetapkan layanan ke penyedia layanan.

Minggu 14 April 2025

  • TermsOfServiceService.AcceptTermsOfService kini menampilkan TermsOfServiceAgremeentState yang diterima dan dienkapsulasi dalam jenis respons.

  • Kata kerja tindakan TermsOfServiceService.AcceptTermsOfService kini adalah POST (sebelumnya GET).

  • Menjelaskan bahwa AccountsService.ListSubAccounts harus dipanggil menggunakan format accounts/... (bukan providers/...). Hal ini untuk menghindari metode ini keluar dari cakupan accounts (artinya GET accounts/123:listSubAccounts, bukan GET providers/123:listSubAccounts).

Minggu 31 Maret 2025

  • Untuk memfilter akun, filter externalAccountId diumumkan tidak digunakan lagi pada minggu 2 Desember 2024 dan kini tidak tersedia. Artinya, pemfilteran berdasarkan externalAccountId kini hanya dapat dilakukan di tingkat service. Filter seperti relationship(externalAccountId = "foo") tidak akan berfungsi lagi dan harus dinyatakan sebagai relationship(service(externalAccountId = "foo")).

  • Menjelaskan dalam dokumentasi AccountsService bahwa Anda tidak dapat membuat akun mandiri.

Minggu 3 Maret 2025

-accounts.onlineReturnPolicies#SeasonalOverride telah difaktorkan ulang untuk meningkatkan kejelasan dan konsistensi. Pembaruan ini mencakup:

  • Penggantian Nama Kolom:
    • begin kini menjadi start_date.
    • end kini menjadi end_date.
  • Penghapusan Kolom:
    • Kolom policy yang tidak digunakan lagi telah dihapus.

-Developer harus memperbarui kode mereka untuk mencerminkan perubahan ini.

Peluncuran layanan AutomaticImprovements yang dapat Anda gunakan untuk mengelola hal berikut:

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan peningkatan kualitas otomatis.

Minggu 17 Februari 2025

Menghapus predikat callerHasAccessToProviderFilter() dari filter akun.

Minggu 10 Februari 2025

  • Meningkatkan kualitas dokumentasi untuk metode AccountsService.List. Metode ini menampilkan semua akun yang dapat diakses pengguna, bukan hanya akun mandiri.

  • Menambahkan batas waktu default 10 menit untuk semua metode RPC.

  • Menambahkan daftar nama program yang tersedia ke accounts.programs deskripsi resource.

  • User.accessRights kini REQUIRED yang memengaruhi metode UserService.Create dan AccountsService.CreateAndConfigure.

Minggu 27 Januari 2025

AccountsService.ListAccounts (dan secara transitif AccountsService.ListSubAccounts) kini menampilkan akun dengan cara yang konsisten pada akhirnya, bukan sebagai pembacaan yang kuat.

Minggu 20 Januari 2025

Kolom users dari CreateAndConfigureAccountRequest tidak digunakan lagi dan diganti dengan user baru. CreateUserRequest yang direferensikan berisi kolom parent yang tidak diperlukan dalam konteks CreateAndConfigureAccountRequest.

Minggu 6 Januari 2025

Kolom user dari pesan CreateUserRequest kini ditandai dengan benar sebagai OPTIONAL.

Kolom domain dalam error yang ditampilkan kini diisi dengan merchantapi.googleapis.com, bukan global

Minggu 2 Desember 2024

Untuk memfilter akun, predikat externalAccountId dipindahkan ke tingkat service dari tingkat relationship. Jadi, filter relationship(externalAccountId = "foo") kini harus ditulis sebagai relationship(service(externalAccountId = "foo")). Format lama masih didukung untuk kompatibilitas mundur, tetapi tidak digunakan lagi dan akan menampilkan error dalam waktu dekat. Semua dokumentasi hanya akan menyebutkan format baru.

Minggu 18 November 2024

Penyedia di kolom CreateAndConfigureAccountRequest.service.provider kini juga dapat berupa salah satu dari providers/GOOGLE_ADS atau providers/GOOGLE_BUSINESS_PROFILE. Akun lain harus disebut sebagai providers/123 (bukan accounts/123). Artinya, kolom tersebut tidak lagi dianotasi sebagai referensi akun. Namun, Anda masih dapat menggunakan nama akun seperti accounts/123 untuk kompatibilitas mundur.

Penyedia di ListSubAccountsRequest kini harus dalam bentuk providers/123, tetapi untuk kompatibilitas mundur, Anda masih dapat menggunakan accounts/123.

Minggu 4 November 2024

Menandai promotions_consent REQUIRED (dari OPTIONAL) di resource BusinessIdentity. Hal ini hanya memengaruhi metode pembaruan. Hal ini untuk mengklarifikasi bahwa promotions_consent tidak dapat diperbarui ke UNSPECIFIED. Hal ini memang tidak dapat dilakukan, tetapi error kini lebih deskriptif dan kolom dianotasi dengan benar.

Minggu 28 Oktober 2024

Meningkatkan kualitas dokumentasi berbagai resource sub-API Akun seperti User, Homepage, BusinessInfo, dan sebagainya.

Minggu 21 Oktober 2024

Meningkatkan kualitas dokumentasi kolom update_mask dalam permintaan pembaruan secara keseluruhan untuk secara khusus menunjukkan kolom mana yang didukung untuk pembaruan.

Menambahkan link pusat bantuan Google Bisnis untuk operator yang didukung ke dokumen eksternal resource ShippingSettings

Minggu 14 Oktober 2024

Menandai provider sebagai REQUIRED di AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Membuat update_mask bersifat opsional di seluruh sub-API Akun (misalnya, identitas bisnis, informasi bisnis, halaman beranda, dll.) dan secara retrospektif untuk resource ConversionSources.

Menambahkan parameter overwrite ke ClaimHomepageRequest.

Minggu 30 September 2024

Peluncuran parameter 'force' untuk metode 'Accounts.delete'.

Minggu 23 September 2024

Menandai region_code dan kind sebagai REQUIRED di RetrieveLatestTermsOfServiceRequest.

Minggu 16 September 2024

Mengubah jenis parameter time_zone menjadi string di ListAccountIssuesRequest

Minggu 12 Agustus 2024

Menambahkan kolom korean_business_registration_number ke resource BusinessInfo.

Minggu 27 Mei 2024

Peluncuran sub-API Akun versi beta