Catatan rilis Merchant Accounts API

Minggu 26 Oktober 2026

  • Mengklarifikasi dokumentasi untuk metode accounts.homepage.unclaim dan kolom claimed dari resource Homepage. Jika akun mewarisi klaim halaman beranda dari akun tingkat lanjutnya, unclaim akan menampilkan respons yang berhasil, tetapi halaman beranda tetap diklaim. Jika akun itu sendiri dikecualikan dari klaim, unclaim akan menampilkan error FAILED_PRECONDITION.

Minggu 28 September 2026

  • Menambahkan youtube_affiliate_management sebagai jenis layanan ke resource AccountService di v1alpha. Catatan: Pengelolaan Afiliasi YouTube adalah fitur dengan akses terbatas.

  • Peluncuran Alpha layanan LoyaltyPrograms yang dapat Anda gunakan untuk mengelola program loyalitas. Fitur ini hanya tersedia untuk penjual tertentu. Untuk mengetahui informasi selengkapnya, lihat Ringkasan program loyalitas.

  • Menambahkan kolom home_page_uri hanya baca ke resource accounts untuk menampilkan URI halaman beranda toko.

Minggu 3 Agustus 2026

  • Menambahkan 'ucp_checkout_management' sebagai jenis layanan ke resource layanan akun. Catatan: Checkout UCP adalah fitur dengan akses terbatas.
  • Menambahkan dukungan untuk program 'ucp-integration' (akses terbatas).
  • Menambahkan dukungan untuk jenis persyaratan layanan 'ucp_integration'.

Minggu 29 Juni 2026

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

Minggu 20 April 2026

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

Minggu 6 April 2026

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

Minggu 16 Maret 2026

  • Meluncurkan metode CreateTestAccount di Accounts API. Hal ini memungkinkan developer membuat akun pengujian khusus secara terprogram yang beroperasi di lingkungan terisolasi seperti sandbox, 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. Tepatnya, hanya salah satu dari AccountAggregation, AccountManagement, dan ComparisonShopping yang harus ditentukan. Selain itu, Anda dapat menentukan jumlah layanan ProductsManagement dan CampaignsManagement arbitrer. 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.

  • CreateAndConfigureAccountRequest.AddAccountService kini memiliki kolom external_account_id (kolom ini sudah ada di resource AccountService). Layanan 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.

  • Sekarang Anda 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.

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

Minggu 10 November 2025

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

Minggu 25 Agustus 2025

  • Metode batch baru ditambahkan ke Regions API:
    • BatchCreateRegions: Memungkinkan pembuatan beberapa region dalam satu permintaan.
    • BatchUpdateRegions: Memungkinkan pembaruan beberapa region dalam satu permintaan.
    • BatchDeleteRegions: Memberikan kemampuan untuk menghapus beberapa region 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

  • Sekarang Anda dapat memfilter akun menurut 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 API program, menghapus pernyataan yang salah bahwa metode Enable/Disable dibatasi untuk pengguna admin.

Minggu 12 Mei 2025

  • Peluncuran resource Kebijakan Pengembalian Barang Online yang memungkinkan pengguna API membuat, memperbarui, dan menghapus kebijakan pengembalian barang.
  • Peluncuran OmnichannelSettingsService dan resource 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 GbpAccountsService dan resource GbpAccount yang memungkinkan pengguna API mengelola Google Profil Bisnis mereka.
  • Luncurkan jenis layanan LocalListingManagement di AccountService, yang menautkan grup lokasi 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 membuat layanan ke penyedia layanan.

Minggu 14 April 2025

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

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

  • Menjelaskan bahwa AccountsService.ListSubAccounts perlu dipanggil menggunakan format accounts/... (bukan providers/...). Hal ini untuk menghindari metode ini keluar dari cakupan accounts (yang berarti 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 menurut 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 pengguna tidak dapat membuat akun mandiri.

Minggu 3 Maret 2025

-accounts.onlineReturnPolicies#SeasonalOverride telah direfaktorisasi untuk meningkatkan kejelasan dan konsistensi. Update ini meliputi:

  • Penggantian Nama Kolom:
    • begin sekarang menjadi start_date.
    • end sekarang 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 informasi selengkapnya, lihat Mengaktifkan peningkatan otomatis.

Minggu 17 Februari 2025

Menghapus predikat callerHasAccessToProviderFilter() dari filter akun.

Minggu 10 Februari 2025

  • Dokumentasi yang lebih baik 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 deskripsi resource accounts.programs.

  • User.accessRights kini menjadi 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 tertunda, bukan pembacaan yang kuat.

Minggu 20 Januari 2025

Kolom users dari CreateAndConfigureAccountRequest tidak digunakan lagi dan digantikan 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") sekarang 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 sekarang harus dalam bentuk providers/123, tetapi untuk kompatibilitas mundur, accounts/123 masih dapat digunakan.

Minggu 4 November 2024

Tandai promotions_consent REQUIRED (dari OPTIONAL) di resource BusinessIdentity. Hal ini hanya memengaruhi metode update. Kami ingin mengklarifikasi bahwa promotions_consent tidak dapat diperbarui ke UNSPECIFIED. Hal ini sebelumnya tidak mungkin dilakukan, tetapi error-nya kini lebih deskriptif dan kolomnya dianotasi dengan benar.

Minggu 28 Oktober 2024

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

Minggu 21 Oktober 2024

Meningkatkan dokumentasi kolom update_mask dalam permintaan update secara keseluruhan untuk menunjukkan secara spesifik kolom mana yang didukung untuk update.

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

Minggu 14 Oktober 2024

Tandai provider sebagai REQUIRED di AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

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

Menambahkan parameter overwrite ke ClaimHomepageRequest.

Minggu 30 September 2024

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

Minggu 23 September 2024

Tandai 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 beta sub-API Accounts