Package google.shopping.merchant.accounts.v1beta

Indeks

AccountIssueService

Layanan untuk mendukung AccountIssueService API.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Mencantumkan semua masalah akun di akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

AccountsService

Layanan untuk mendukung Accounts API.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Membuat akun Merchant Center mandiri dengan konfigurasi tambahan. Menambahkan pengguna yang membuat permintaan sebagai admin untuk akun baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Menghapus akun yang ditentukan, apa pun jenisnya: mandiri, MCA, atau sub-akun. Menghapus MCA akan menyebabkan penghapusan semua sub-akunnya. Untuk menjalankan metode ini, Anda memerlukan akses admin. Penghapusan hanya berhasil jika akun tidak menyediakan layanan ke akun lain dan tidak memiliki penawaran yang diproses. Anda dapat menggunakan parameter force untuk menggantinya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Mengambil akun dari akun Merchant Center Anda. Setelah menyisipkan, memperbarui, atau menghapus akun, mungkin perlu waktu beberapa menit sebelum perubahan diterapkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Mencantumkan akun yang dapat diakses oleh pengguna yang memanggil dan cocok dengan batasan permintaan seperti ukuran halaman atau filter. Tindakan ini tidak hanya mencantumkan sub-akun MCA, tetapi semua akun yang dapat diakses oleh pengguna yang melakukan panggilan, termasuk MCA lain, akun tertaut, akun mandiri, dan sebagainya. Jika tidak ada filter yang diberikan, akun yang akan ditampilkan adalah akun tempat pengguna ditambahkan secara langsung. Metode ini pada akhirnya konsisten, yang berarti perubahan seperti membuat, memperbarui akun, atau perubahan hubungan antar-akun mungkin tidak langsung muncul dalam hasil. Sebagai gantinya, perubahan ini akan diterapkan dalam waktu singkat, setelah itu informasi yang diperbarui dapat cocok dengan predikat terkait. Artinya, penelusuran berdasarkan nama akun mungkin tidak menampilkan akun yang baru-baru ini diubah meskipun memenuhi predikat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Mencantumkan semua sub-akun untuk akun multiklien tertentu. Ini adalah wrapper praktis untuk metode ListAccounts yang lebih canggih. Metode ini akan menghasilkan hasil yang sama seperti memanggil ListsAccounts dengan filter berikut: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Memperbarui akun, apa pun jenisnya: mandiri, MCA, atau sub-akun. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

AutofeedSettingsService

Layanan untuk mendukung setelan feed otomatis.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Mengambil setelan feed otomatis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Memperbarui setelan feed otomatis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

BusinessIdentityService

Layanan untuk mendukung identitas bisnis API.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Mengambil identitas bisnis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Memperbarui identitas bisnis akun. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

BusinessInfoService

Layanan untuk mendukung API info bisnis.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Mengambil info bisnis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Memperbarui info bisnis akun. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

EmailPreferencesService

Layanan untuk mendukung EmailPreferences API.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Menampilkan preferensi email untuk pengguna akun Merchant Center. Layanan ini hanya mengizinkan pengambilan dan pembaruan preferensi email untuk pengguna yang diautentikasi. Gunakan alias name=accounts/*/users/me/emailPreferences untuk mendapatkan preferensi bagi pengguna yang diautentikasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Memperbarui preferensi email untuk pengguna akun Merchant Center. Pengguna MCA harus menentukan akun MCA, bukan sub-akun MCA.

Preferensi yang tidak dipilih secara eksplisit di mask pembaruan tidak akan diperbarui.

Pembaruan yang menentukan nilai status keikutsertaan UNCONFIRMED tidak valid.

Gunakan alias name=accounts/*/users/me/emailPreferences untuk memperbarui preferensi bagi pengguna yang diautentikasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

HomepageService

Layanan untuk mendukung API bagi halaman beranda Play Store.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Mengklaim halaman beranda toko. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Jika halaman beranda sudah diklaim, tindakan ini akan memeriksa ulang verifikasi (kecuali jika penjual dikecualikan dari klaim, yang juga dikecualikan dari verifikasi) dan menampilkan respons yang berhasil. Jika kepemilikan tidak dapat diverifikasi lagi, error akan ditampilkan, tetapi klaim tidak akan dihapus. Jika gagal, pesan error kanonis akan ditampilkan: * PERMISSION_DENIED: pengguna tidak memiliki izin yang diperlukan di akun MC ini; * FAILED_PRECONDITION: - Akun bukan akun Merchant Center; - Akun MC tidak memiliki halaman beranda; - klaim gagal (dalam hal ini, pesan error akan berisi detail selengkapnya).

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Mengambil halaman beranda toko.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Membatalkan klaim halaman beranda toko. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Memperbarui halaman beranda toko. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

OnlineReturnPolicyService

Layanan ini memfasilitasi pengelolaan konfigurasi kebijakan pengembalian karena menyesal dari penjual, yang mencakup kebijakan pengembalian untuk iklan dan listingan gratis

program. API ini menentukan model resource berikut:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Mendapatkan kebijakan pengembalian yang ada untuk penjual tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Mencantumkan semua kebijakan pengembalian yang ada untuk penjual tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ProgramsService

Layanan untuk pengelolaan program.

Program menyediakan mekanisme untuk menambahkan fungsi ke akun penjual. Contoh umum dari hal ini adalah program Listingan produk gratis, yang memungkinkan produk dari toko penjual ditampilkan di Google secara gratis.

Layanan ini mengekspos metode untuk mengambil partisipasi penjual dalam semua program yang tersedia, selain metode untuk mengaktifkan atau menonaktifkan partisipasi secara eksplisit dalam setiap program.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Menonaktifkan partisipasi dalam program yang ditentukan untuk akun. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Mengaktifkan partisipasi dalam program yang ditentukan untuk akun. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Mengambil program yang ditentukan untuk akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Mengambil semua program untuk akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

RegionsService

Mengelola konfigurasi region.

API ini menentukan model resource berikut:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Membuat definisi wilayah di akun Merchant Center Anda. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Menghapus definisi wilayah dari akun Merchant Center Anda. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Mengambil wilayah yang ditentukan di akun Merchant Center Anda.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Mencantumkan wilayah di akun Merchant Center Anda.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Memperbarui definisi wilayah di akun Merchant Center Anda. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ShippingSettingsService

Layanan untuk mendapatkan informasi setelan pengiriman panggilan metode per metode Merchant API.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Mengambil informasi setelan pengiriman.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Ganti setelan pengiriman penjual dengan setelan pengiriman permintaan. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

TermsOfServiceAgreementStateService

Layanan untuk mendukung TermsOfServiceAgreementState API.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Menampilkan status perjanjian persyaratan layanan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Mengambil status perjanjian untuk persyaratan layanan aplikasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

TermsOfServiceService

Layanan untuk mendukung TermsOfService API.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Menerima TermsOfService. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Mengambil TermsOfService yang terkait dengan versi yang disediakan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Mengambil TermsOfService versi terbaru untuk kind dan region_code tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UserService

Layanan untuk mendukung API pengguna.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Membuat pengguna akun Merchant Center. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Menghapus pengguna akun Merchant Center. Untuk menjalankan metode ini, Anda memerlukan akses admin. Pengguna yang akan dihapus tidak boleh merupakan pengguna admin terakhir dari akun tersebut. Selain itu, pengguna dilindungi dari penghapusan jika dikelola oleh Pengelola Bisnis"

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

GetUser

rpc GetUser(GetUserRequest) returns (User)

Mengambil pengguna akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Mencantumkan semua pengguna akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Memperbarui pengguna akun Merchant Center. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/content

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

AcceptTermsOfServiceRequest

Pesan permintaan untuk metode AcceptTermsOfService.

Kolom
name

string

Wajib. Nama resource versi persyaratan layanan. Format: termsOfService/{version}

account

string

Wajib. Akun yang akan menyetujui ToS.

region_code

string

Wajib. Kode wilayah seperti yang ditentukan oleh CLDR. Ini adalah negara jika ToS berlaku secara khusus untuk negara tersebut atau 001 jika berlaku secara global.

Diterima

Menjelaskan persyaratan layanan yang disetujui.

Kolom
terms_of_service

string

termsOfService yang disetujui.

accepted_by

string

Akun tempat persetujuan dicatat. Akun ini dapat berupa akun itu sendiri atau, dalam kasus sub-akun, akun MCA.

valid_until

Date

Jika ditetapkan, kolom ini menyatakan bahwa TermsOfService yang diterima hanya berlaku hingga akhir tanggal ini (dalam UTC). Sebelum tanggal tersebut, Anda harus menyetujui perjanjian baru. Informasi TermsOfService yang diperlukan ditemukan dalam pesan Required.

AccessRight

Hak akses.

Enum
ACCESS_RIGHT_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
STANDARD Hak akses standar.
ADMIN Hak akses admin.
PERFORMANCE_REPORTING Pengguna dengan hak ini memiliki akses ke performa dan insight.

Akun

Pesan Account mewakili akun penjual dalam Iklan Shopping. Ini adalah entitas utama untuk mengelola data produk, setelan, dan interaksi dengan layanan Google dan penyedia eksternal.

Akun dapat beroperasi sebagai entitas mandiri atau menjadi bagian dari struktur akun multiklien (MCA). Dalam konfigurasi MCA, akun induk mengelola beberapa sub-akun.

Membuat akun melibatkan konfigurasi atribut seperti nama akun, zona waktu, dan preferensi bahasa.

Pesan Account adalah entitas induk untuk banyak resource lainnya, misalnya, AccountRelationship, Homepage, BusinessInfo, dan sebagainya.

Kolom
name

string

ID. Nama resource akun. Format: accounts/{account}

account_id

int64

Hanya output. ID akun.

account_name

string

Wajib. Nama akun yang dapat dibaca manusia. Lihat nama toko dan nama bisnis untuk mengetahui informasi selengkapnya.

adult_content

bool

Untuk menunjukkan bahwa akun ini berisi konten khusus dewasa.

test_account

bool

Hanya output. Apakah ini akun percobaan.

time_zone

TimeZone

Wajib. Zona waktu akun.

Saat menulis, time_zone menetapkan reporting_time_zone dan display_time_zone.

Untuk operasi baca, time_zone selalu menampilkan display_time_zone. Jika display_time_zone tidak ada untuk akun Anda, time_zone akan kosong.

language_code

string

Wajib. Kode bahasa BCP-47 akun, seperti en-US atau sr-Latn.

AccountAggregation

Jenis ini tidak memiliki kolom.

Payload AccountAggregation.

AccountIssue

AccountIssue.

Kolom
name

string

ID. Nama resource masalah akun. Format: accounts/{account}/issues/{id}

title

string

Judul masalah yang dilokalkan.

severity

Severity

Tingkat keparahan masalah secara keseluruhan.

impacted_destinations[]

ImpactedDestination

Dampak masalah ini terhadap berbagai tujuan.

detail

string

Detail lebih lanjut yang dilokalkan tentang masalah tersebut.

documentation_uri

string

Link ke Pusat Bantuan Merchant Center yang memberikan informasi lebih lanjut tentang masalah tersebut dan cara memperbaikinya.

ImpactedDestination

Dampak masalah pada tujuan.

Kolom
impacts[]

Impact

Dampak (negatif) untuk berbagai wilayah pada tujuan tertentu.

reporting_context

ReportingContextEnum

Konteks pelaporan yang terpengaruh.

Dampak

Dampak masalah pada suatu wilayah.

Kolom
region_code

string

Kode wilayah CLDR tempat masalah ini berlaku.

severity

Severity

Tingkat keparahan masalah di tujuan dan wilayah.

Keparahan

Semua kemungkinan tingkat keparahan masalah.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak diketahui.
CRITICAL Masalah ini menyebabkan penawaran tidak ditayangkan.
ERROR Masalah ini mungkin memengaruhi penawaran (di masa mendatang) atau mungkin merupakan indikator masalah pada penawaran.
SUGGESTION Masalahnya adalah saran untuk peningkatan.

Alamat

Alamat pengiriman gudang.

Kolom
street_address

string

Bagian alamat di tingkat jalan. Misalnya: 111w 31st Street.

city

string

Wajib. Kota, kota kecil, atau komune. Dapat juga mencakup lokalitas atau sublokalitas dependen (Misalnya lingkungan atau pinggiran kota).

administrative_area

string

Wajib. Subdivisi administratif tingkat atas negara. Misalnya, negara bagian seperti California ("CA") atau provinsi seperti Quebec ("QC").

postal_code

string

Wajib. Kode pos (Misalnya "94043").

region_code

string

Wajib. Kode negara CLDR (Misalnya "US").

AutofeedSettings

Pengumpulan informasi yang terkait dengan setelan feed otomatis.

Kolom
name

string

ID. Nama resource setelan feed otomatis. Format: accounts/{account}/autofeedSettings.

enable_products

bool

Wajib. Mengaktifkan atau menonaktifkan crawling produk melalui feed otomatis untuk akun tertentu. Akun feed otomatis harus memenuhi kondisi tertentu, yang dapat diperiksa melalui kolom eligible. Akun tersebut tidak boleh berupa marketplace. Saat feed otomatis diaktifkan untuk pertama kalinya, produk biasanya akan langsung muncul. Saat diaktifkan kembali, mungkin perlu waktu hingga 24 jam agar produk muncul.

eligible

bool

Hanya output. Menentukan apakah penjual memenuhi syarat untuk didaftarkan ke feed otomatis.

BusinessDayConfig

Hari kerja gudang.

Kolom
business_days[]

Weekday

Wajib. Hari kerja reguler. Tidak boleh kosong.

Hari kerja

Enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Kumpulan informasi yang terkait dengan identitas bisnis.

Kolom
name

string

ID. Nama resource identitas bisnis. Format: accounts/{account}/businessIdentity

black_owned

IdentityAttribute

Opsional. Menentukan apakah bisnis mengidentifikasi dirinya sebagai milik orang kulit hitam. Kolom opsional ini hanya akan tersedia untuk penjual dengan negara bisnis yang ditetapkan ke US. Kebijakan ini juga tidak berlaku untuk marketplace atau penjual marketplace.

women_owned

IdentityAttribute

Opsional. Menentukan apakah bisnis mengidentifikasi dirinya sebagai milik perempuan. Kolom opsional ini hanya akan tersedia untuk penjual dengan negara bisnis yang ditetapkan ke US. Kebijakan ini juga tidak berlaku untuk marketplace atau penjual marketplace.

veteran_owned

IdentityAttribute

Opsional. Menentukan apakah bisnis mengidentifikasi diri sebagai milik veteran. Kolom opsional ini hanya akan tersedia untuk penjual dengan negara bisnis yang ditetapkan ke US. Kebijakan ini juga tidak berlaku untuk marketplace atau penjual marketplace.

latino_owned

IdentityAttribute

Opsional. Menentukan apakah bisnis mengidentifikasi dirinya sebagai milik orang Latin. Kolom opsional ini hanya akan tersedia untuk penjual dengan negara bisnis yang ditetapkan ke US. Kebijakan ini juga tidak berlaku untuk marketplace atau penjual marketplace.

small_business

IdentityAttribute

Opsional. Menentukan apakah bisnis mengidentifikasi dirinya sebagai bisnis kecil. Kolom opsional ini hanya akan tersedia untuk penjual dengan negara bisnis yang ditetapkan ke US. Hal ini juga tidak berlaku untuk marketplace.

IdentityAttribute

Semua informasi yang terkait dengan atribut identitas.

Kolom
identity_declaration

IdentityDeclaration

Wajib. Pernyataan identitas untuk atribut ini.

IdentityDeclaration

Semua kemungkinan setelan terkait pernyataan identitas.

Enum
IDENTITY_DECLARATION_UNSPECIFIED Nilai default yang menunjukkan bahwa tidak ada pilihan yang dibuat.
SELF_IDENTIFIES_AS Menunjukkan bahwa akun mengidentifikasi dengan atribut.
DOES_NOT_SELF_IDENTIFY_AS Menunjukkan bahwa akun tidak mengidentifikasi dengan atribut.

PromotionsConsent

Semua kemungkinan setelan terkait promosi yang terkait dengan identitas bisnis.

Enum

BusinessInfo

Pesan BusinessInfo berisi informasi penting tentang bisnis penjual.

Pesan ini berisi detail bisnis utama seperti alamat fisik, kontak layanan pelanggan, dan ID khusus wilayah.

Kolom
name

string

ID. Nama resource info bisnis. Format: accounts/{account}/businessInfo

address

PostalAddress

Opsional. Alamat bisnis. Hanya kolom region_code, address_lines, postal_code, administrative_area, dan locality yang didukung. Semua kolom lainnya diabaikan.

phone

PhoneNumber

Hanya output. Nomor telepon bisnis.

phone_verification_state

PhoneVerificationState

Hanya output. Status verifikasi telepon bisnis.

customer_service

CustomerService

Opsional. Layanan pelanggan bisnis.

korean_business_registration_number

string

Opsional. Nomor pendaftaran bisnis Korea 10 digit yang dipisahkan dengan tanda hubung dalam format: XXX-XX-XXXXX.

CarrierRate

Daftar tarif operator yang dapat dirujuk oleh main_table atau single_value. Layanan operator yang didukung ditentukan di https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Kolom
name

string

Wajib. Nama tarif ekspedisi. Harus unik per grup tarif.

carrier

string

Wajib. Layanan operator, seperti "UPS" atau "Fedex".

carrier_service

string

Wajib. Layanan operator, seperti "ground" atau "2 days".

origin_postal_code

string

Wajib. Asal pengiriman untuk tarif ekspedisi ini.

percentage_adjustment

string

Opsional. Pengubah tarif pengiriman multiplikatif sebagai angka dalam notasi desimal. Dapat berupa negatif. Misalnya, "5.4" meningkatkan tarif sebesar 5,4%, "-3" menurunkan tarif sebesar 3%.

flat_adjustment

Price

Opsional. Pengubah tarif pengiriman tambahan. Dapat berupa negatif. Misalnya, { "amount_micros": 1, "currency_code" : "USD" } menambahkan $1 ke tarif, { "amount_micros": -3, "currency_code" : "USD" } menghapus $3 dari tarif.

ClaimHomepageRequest

Pesan permintaan untuk metode ClaimHomepage.

Kolom
name

string

Wajib. Nama halaman beranda yang akan diklaim. Format: accounts/{account}/homepage

overwrite

bool

Opsional. Jika ditetapkan ke true, opsi ini akan menghapus klaim yang ada di situs yang diminta dan menggantinya dengan klaim dari akun yang membuat permintaan.

CreateAndConfigureAccountRequest

Pesan permintaan untuk metode CreateAndConfigureAccount.

Kolom
account

Account

Wajib. Akun yang akan dibuat.

users[]
(deprecated)

CreateUserRequest

Opsional. Pengguna yang akan ditambahkan ke akun.

Kolom ini tidak digunakan lagi dan tidak akan ada setelah API berevolusi dari versi beta. Sebagai gantinya, gunakan kolom user.

user[]

AddUser

Opsional. Pengguna yang akan ditambahkan ke akun.

service[]

AddAccountService

Wajib. Layanan akun antara akun yang akan dibuat dan akun penyedia diinisialisasi sebagai bagian dari pembuatan. Setidaknya satu layanan tersebut harus disediakan. Saat ini, salah satu dari keduanya harus berupa account_aggregation, yang berarti Anda hanya dapat membuat sub-akun, bukan akun mandiri melalui metode ini. Layanan account_management atau product_management tambahan dapat disediakan.

AddAccountService

Petunjuk tambahan untuk menambahkan layanan akun selama pembuatan akun.

Kolom
Kolom union service_type. Jenis layanan yang akan ditambahkan. service_type hanya dapat berupa salah satu dari berikut:
account_aggregation

AccountAggregation

Penyedia adalah agregator untuk akun. Payload untuk jenis layanan Agregasi Akun.

provider

string

Wajib. Penyedia layanan. Referensi ke akun seperti providers/123 atau penyedia layanan terkenal (salah satu dari providers/GOOGLE_ADS atau providers/GOOGLE_BUSINESS_PROFILE).

AddUser

Petunjuk untuk menambahkan pengguna ke akun selama pembuatan.

Kolom
user_id

string

Wajib. Alamat email pengguna (misalnya, john.doe@gmail.com).

user

User

Opsional. Detail tentang pengguna yang akan ditambahkan. Saat ini, hanya hak akses yang dapat ditentukan.

CreateRegionRequest

Pesan permintaan untuk metode CreateRegion.

Kolom
parent

string

Wajib. Akun yang akan dibuatkan region. Format: accounts/{account}

region_id

string

Wajib. ID untuk wilayah, unik di semua wilayah akun yang sama.

region

Region

Wajib. Region yang akan dibuat.

CreateUserRequest

Pesan permintaan untuk metode CreateUser.

Kolom
parent

string

Wajib. Nama resource akun yang akan dibuat pengguna. Format: accounts/{account}

user_id

string

Wajib. Alamat email pengguna (misalnya, john.doe@gmail.com).

user

User

Opsional. Pengguna yang akan dibuat.

CustomerService

Informasi layanan pelanggan.

Kolom
uri

string

Opsional. URI tempat layanan pelanggan dapat ditemukan.

email

string

Opsional. Alamat email yang dapat digunakan untuk menghubungi layanan pelanggan.

phone

PhoneNumber

Opsional. Nomor telepon yang dapat dihubungi layanan pelanggan.

CutoffTime

Definisi waktu batas hari kerja.

Kolom
hour

int32

Wajib. Jam batas waktu hingga pesanan harus dilakukan agar diproses pada hari yang sama.

minute

int32

Wajib. Menit batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama.

time_zone

string

Wajib. ID zona waktu Misalnya "Eropa/Zurich".

DeleteAccountRequest

Pesan permintaan untuk metode DeleteAccount.

Kolom
name

string

Wajib. Nama akun yang akan dihapus. Format: accounts/{account}

force

bool

Opsional. Jika ditetapkan ke true, akun akan dihapus meskipun akun tersebut menyediakan layanan ke akun lain atau telah memproses penawaran.

DeleteRegionRequest

Pesan permintaan untuk metode DeleteRegion.

Kolom
name

string

Wajib. Nama wilayah yang akan dihapus. Format: accounts/{account}/regions/{region}

DeleteUserRequest

Pesan permintaan untuk metode DeleteUser.

Kolom
name

string

Wajib. Nama pengguna yang akan dihapus. Format: accounts/{account}/users/{email}

Anda juga dapat menghapus pengguna yang sesuai dengan pemanggil menggunakan me, bukan alamat email seperti di accounts/{account}/users/me.

DeliveryTime

Waktu yang dihabiskan dalam berbagai aspek mulai dari pemesanan hingga pengiriman produk.

Kolom
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Opsional. Menunjukkan bahwa waktu pengiriman harus dihitung per gudang (lokasi asal pengiriman) berdasarkan setelan ekspedisi yang dipilih. Jika ditetapkan, tidak ada kolom terkait waktu transit lainnya di [waktu pengiriman][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] yang boleh ditetapkan.

min_transit_days

int32

Jumlah minimum hari kerja yang dihabiskan dalam pengiriman. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya. min_transit_days, max_transit_days, atau transit_time_table harus ditetapkan, tetapi tidak boleh keduanya.

max_transit_days

int32

Jumlah maksimum hari kerja yang dihabiskan dalam pengiriman. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya. Harus lebih besar dari atau sama dengan min_transit_days.

cutoff_time

CutoffTime

Definisi waktu batas hari kerja. Jika tidak dikonfigurasi, waktu batas akan ditetapkan secara default ke 08.00 PST.

min_handling_days

int32

Jumlah minimum hari kerja yang dihabiskan sebelum pesanan dikirim. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. 'min_handling_days' dan 'max_handling_days' harus ditetapkan atau tidak ditetapkan secara bersamaan.

max_handling_days

int32

Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirim. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. Harus lebih besar dari atau sama dengan min_handling_days. 'min_handling_days' dan 'max_handling_days' harus ditetapkan atau tidak ditetapkan secara bersamaan.

transit_time_table

TransitTable

Tabel waktu transit, jumlah hari kerja yang dihabiskan dalam transit berdasarkan dimensi baris dan kolom. min_transit_days, max_transit_days, atau transit_time_table dapat ditetapkan, tetapi tidak keduanya.

handling_business_day_config

BusinessDayConfig

Hari kerja saat pesanan dapat ditangani. Jika tidak disediakan, hari kerja Senin hingga Jumat akan diasumsikan.

transit_business_day_config

BusinessDayConfig

Hari kerja saat pesanan dapat dalam perjalanan. Jika tidak disediakan, hari kerja Senin hingga Jumat akan diasumsikan.

DisableProgramRequest

Pesan permintaan untuk metode DisableProgram.

Kolom
name

string

Wajib. Nama program yang partisipasinya akan dinonaktifkan untuk akun tertentu. Format: accounts/{account}/programs/{program}

Jarak

Radius pengiriman maksimum. Hal ini hanya diperlukan untuk jenis pengiriman pengiriman lokal.

Kolom
value

int64

Nilai bilangan bulat jarak.

unit

Unit

Satuan dapat berbeda berdasarkan negara, dan diparameterkan untuk menyertakan mil dan kilometer.

Unit

Satuan dapat berbeda berdasarkan negara, dan diparameterkan untuk menyertakan mil dan kilometer.

Enum
UNIT_UNSPECIFIED Unit tidak ditentukan
MILES Satuan dalam mil
KILOMETERS Satuan dalam kilometer

EmailPreferences

Kategori notifikasi yang dipilih pengguna untuk diterima / tidak diterima. Preferensi email tidak menyertakan pengumuman wajib karena pengguna tidak dapat memilih untuk tidak menerimanya.

Kolom
name

string

ID. Nama EmailPreferences. Endpoint hanya didukung untuk pengguna yang diautentikasi.

news_and_tips

OptInState

Opsional. Info terbaru tentang fitur baru, tips, dan praktik terbaik.

OptInState

Status keikutsertaan preferensi email.

Enum
OPT_IN_STATE_UNSPECIFIED Status keikutsertaan tidak ditentukan.
OPTED_OUT Pengguna memilih untuk tidak menerima jenis email ini.
OPTED_IN Pengguna telah memilih untuk menerima jenis email ini.
UNCONFIRMED Pengguna telah memilih untuk menerima jenis email ini dan email konfirmasi telah dikirim, tetapi pengguna belum mengonfirmasi keikutsertaannya (hanya berlaku untuk negara tertentu).

EnableProgramRequest

Pesan permintaan untuk metode EnableProgram.

Kolom
name

string

Wajib. Nama program yang partisipasinya akan diaktifkan untuk akun tertentu. Format: accounts/{account}/programs/{program}

GetAccountRequest

Pesan permintaan untuk metode GetAccount.

Kolom
name

string

Wajib. Nama akun yang akan diambil. Format: accounts/{account}

GetAutofeedSettingsRequest

Pesan permintaan untuk metode GetAutofeedSettings.

Kolom
name

string

Wajib. Nama resource setelan feed otomatis. Format: accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

Pesan permintaan untuk metode GetBusinessIdentity.

Kolom
name

string

Wajib. Nama resource identitas bisnis. Format: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Pesan permintaan untuk metode GetBusinessInfo.

Kolom
name

string

Wajib. Nama resource info bisnis. Format: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Pesan permintaan untuk metode GetEmailPreferences.

Kolom
name

string

Wajib. Nama resource EmailPreferences. Format: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Pesan permintaan untuk metode GetHomepage.

Kolom
name

string

Wajib. Nama halaman beranda yang akan diambil. Format: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Pesan permintaan untuk metode GetOnlineReturnPolicy.

Kolom
name

string

Wajib. Nama kebijakan pengembalian yang akan diambil. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Pesan permintaan untuk metode GetProgram.

Kolom
name

string

Wajib. Nama program yang akan diambil. Format: accounts/{account}/programs/{program}

GetRegionRequest

Pesan permintaan untuk metode GetRegion.

Kolom
name

string

Wajib. Nama wilayah yang akan diambil. Format: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Pesan permintaan untuk metode GetShippingSetting.

Kolom
name

string

Wajib. Nama setelan pengiriman yang akan diambil. Format: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Pesan permintaan untuk metode GetTermsOfServiceAgreementState.

Kolom
name

string

Wajib. Nama resource versi persyaratan layanan. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Format ID adalah: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

Pesan permintaan untuk metode GetTermsOfService.

Kolom
name

string

Wajib. Nama resource versi persyaratan layanan. Format: termsOfService/{version}

GetUserRequest

Pesan permintaan untuk metode GetUser.

Kolom
name

string

Wajib. Nama pengguna yang akan diambil. Format: accounts/{account}/users/{email}

Anda juga dapat mengambil pengguna yang sesuai dengan pemanggil menggunakan me, bukan alamat email seperti dalam accounts/{account}/users/me.

Header

Daftar header baris atau kolom yang tidak kosong untuk tabel. Salah satu dari prices, weights, num_items, postal_code_group_names, atau location harus ditetapkan.

Kolom
prices[]

Price

Wajib. Daftar batas atas harga pesanan inklusif. Nilai harga terakhir dapat berupa tak terhingga dengan menetapkan harga amount_micros = -1. Misalnya, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] mewakili header "<= $10", "<= $500", dan "> $500". Semua harga dalam layanan harus memiliki mata uang yang sama. Tidak boleh kosong. Harus positif, kecuali -1. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

weights[]

Weight

Wajib. Daftar batas atas bobot pesanan inklusif. Nilai bobot terakhir dapat berupa tak terbatas dengan menetapkan price amount_micros = -1. Misalnya, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] mewakili header "<= 10kg", "<= 50kg", dan "> 50kg". Semua bobot dalam layanan harus memiliki unit yang sama. Tidak boleh kosong. Harus positif, kecuali -1. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

number_of_items[]

string

Wajib. Daftar jumlah batas atas item inklusif. Nilai terakhir dapat berupa "infinity". Misalnya, ["10", "50", "infinity"] mewakili header "<= 10 item", "<= 50 item", dan "> 50 item". Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

postal_code_group_names[]

string

Wajib. Daftar nama grup pos. Nilai terakhir dapat berupa "all other locations". Contoh: ["zone 1", "zone 2", "all other locations"]. Grup kode pos yang dirujuk harus cocok dengan negara pengiriman layanan. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

locations[]

LocationIdSet

Wajib. Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

Halaman Beranda

Pesan Homepage mewakili halaman beranda toko penjual dalam sistem.

Halaman beranda penjual adalah domain utama tempat pelanggan berinteraksi dengan tokonya.

Halaman beranda dapat diklaim dan diverifikasi sebagai bukti kepemilikan dan memungkinkan penjual mengakses fitur yang memerlukan situs terverifikasi. Untuk informasi selengkapnya, lihat Memahami verifikasi URL toko online.

Kolom
name

string

ID. Nama resource halaman beranda toko. Format: accounts/{account}/homepage

claimed

bool

Hanya output. Apakah halaman beranda diklaim. Lihat https://support.google.com/merchants/answer/176793.

uri

string

Wajib. URI (biasanya URL) halaman beranda toko.

InsertShippingSettingsRequest

Pesan permintaan untuk metode InsertShippingSetting.

Kolom
parent

string

Wajib. Akun tempat produk ini akan disisipkan. Format: accounts/{account}

shipping_setting

ShippingSettings

Wajib. Versi baru akun.

ListAccountIssuesRequest

Pesan permintaan untuk metode ListAccountIssues.

Kolom
parent

string

Wajib. Induk, yang memiliki kumpulan masalah ini. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum masalah yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 50 pengguna akan ditampilkan. Nilai maksimum adalah 100; nilai di atas 100 akan dikonversi menjadi 100

page_token

string

Opsional. Token halaman, diterima dari panggilan ListAccountIssues sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListAccountIssues harus sesuai dengan panggilan yang menyediakan token halaman.

language_code

string

Opsional. Masalah dalam respons akan memiliki kolom yang dapat dibaca manusia dalam bahasa yang diberikan. Formatnya adalah BCP-47, seperti en-US atau sr-Latn. Jika tidak ada nilai yang diberikan, en-US akan digunakan.

time_zone

string

Opsional. Zona waktu IANA yang digunakan untuk melokalkan waktu di kolom yang dapat dibaca manusia. Misalnya, 'America/Los_Angeles'. Jika tidak ditetapkan, 'America/Los_Angeles' akan digunakan.

ListAccountIssuesResponse

Pesan respons untuk metode ListAccountIssues.

Kolom
account_issues[]

AccountIssue

Masalah dari akun yang ditentukan.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListAccountsRequest

Pesan permintaan untuk metode ListAccounts.

Kolom
page_size

int32

Opsional. Jumlah maksimum akun yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 250 akun akan ditampilkan. Nilai maksimum adalah 500; nilai di atas 500 akan dikonversi menjadi 500.

page_token

string

Opsional. Token halaman, diterima dari panggilan ListAccounts sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListAccounts harus sesuai dengan panggilan yang menyediakan token halaman.

filter

string

Opsional. Hanya menampilkan akun yang cocok dengan filter. Untuk detail selengkapnya, lihat referensi sintaksis filter.

ListAccountsResponse

Pesan respons untuk metode ListAccounts.

Kolom
accounts[]

Account

Akun yang cocok dengan ListAccountsRequest.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListOnlineReturnPoliciesRequest

Pesan permintaan untuk metode ListOnlineReturnPolicies.

Kolom
parent

string

Wajib. Akun penjual yang akan mencantumkan kebijakan pengembalian. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum resource OnlineReturnPolicy yang akan ditampilkan. Layanan menampilkan lebih sedikit dari nilai ini jika jumlah kebijakan pengembalian untuk penjual tertentu kurang dari pageSize. Nilai defaultnya adalah 10. Nilai maksimumnya adalah 100; Jika nilai yang lebih tinggi dari maksimum ditentukan, pageSize akan ditetapkan secara default ke nilai maksimum

page_token

string

Opsional. Token halaman, diterima dari panggilan ListOnlineReturnPolicies sebelumnya. Berikan token halaman untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListOnlineReturnPolicies harus sesuai dengan panggilan yang menyediakan token halaman. Token ditampilkan sebagai nextPageToken dalam respons terhadap permintaan sebelumnya.

ListOnlineReturnPoliciesResponse

Pesan respons untuk metode ListOnlineReturnPolicies.

Kolom
online_return_policies[]

OnlineReturnPolicy

Kebijakan pengembalian yang diambil.

next_page_token

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListProgramsRequest

Pesan permintaan untuk metode ListPrograms.

Kolom
parent

string

Wajib. Nama akun yang akan mengambil semua program. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum program yang akan ditampilkan dalam satu respons. Jika tidak ditentukan (atau 0), ukuran default 1000 akan digunakan. Nilai maksimumnya adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.

page_token

string

Opsional. Token lanjutan, diterima dari panggilan ListPrograms sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

ListProgramsResponse

Pesan respons untuk metode ListPrograms.

Kolom
programs[]

Program

Program untuk akun tertentu.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListRegionsRequest

Pesan permintaan untuk metode ListRegions.

Kolom
parent

string

Wajib. Akun yang akan mencantumkan region. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum wilayah yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 region akan ditampilkan. Nilai maksimumnya adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.

page_token

string

Opsional. Token halaman, diterima dari panggilan ListRegions sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListRegions harus sesuai dengan panggilan yang menyediakan token halaman.

ListRegionsResponse

Pesan respons untuk metode ListRegions.

Kolom
regions[]

Region

Wilayah dari penjual yang ditentukan.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListSubAccountsRequest

Pesan permintaan untuk metode ListSubAccounts.

Kolom
provider

string

Wajib. Penyedia layanan agregasi. Format: providers/{providerId}

page_size

int32

Opsional. Jumlah maksimum akun yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 250 akun akan ditampilkan. Nilai maksimum adalah 500; nilai di atas 500 akan dikonversi menjadi 500.

page_token

string

Opsional. Token halaman, diterima dari panggilan ListAccounts sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListAccounts harus sesuai dengan panggilan yang menyediakan token halaman.

ListSubAccountsResponse

Pesan respons untuk metode ListSubAccounts.

Kolom
accounts[]

Account

Akun yang akun induknya adalah agregator.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

ListUsersRequest

Pesan permintaan untuk metode ListUsers.

Kolom
parent

string

Wajib. Induk, yang memiliki kumpulan pengguna ini. Format: accounts/{account}

page_size

int32

Opsional. Jumlah maksimum pengguna yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, maksimal 50 pengguna akan ditampilkan. Nilai maksimum adalah 100; nilai di atas 100 akan dikonversi menjadi 100

page_token

string

Opsional. Token halaman, diterima dari panggilan ListUsers sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk ListUsers harus sesuai dengan panggilan yang menyediakan token halaman.

ListUsersResponse

Pesan respons untuk metode ListUsers.

Kolom
users[]

User

Pengguna dari akun yang ditentukan.

next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

LocationIdSet

Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

Kolom
location_ids[]

string

Wajib. Daftar ID lokasi yang tidak kosong. Semuanya harus memiliki jenis lokasi yang sama (Misalnya, negara bagian).

MinimumOrderValueTable

Tabel nilai pesanan minimum per toko untuk jenis fulfillment pengambilan.

Kolom
store_code_set_with_movs[]

StoreCodeSetWithMov

Wajib. Daftar kumpulan kode toko yang memiliki nilai pesanan minimum (MOV) yang sama. Setidaknya diperlukan dua set dan set terakhir harus kosong, yang menandakan 'MOV untuk semua toko lainnya'. Setiap kode toko hanya dapat muncul satu kali di semua set. Semua harga dalam layanan harus memiliki mata uang yang sama.

StoreCodeSetWithMov

Daftar kumpulan kode toko yang memiliki nilai pesanan minimum yang sama. Setidaknya diperlukan dua set dan set terakhir harus kosong, yang menandakan 'MOV untuk semua toko lainnya'. Setiap kode toko hanya dapat muncul satu kali di semua set. Semua harga dalam layanan harus memiliki mata uang yang sama.

Kolom
store_codes[]

string

Opsional. Daftar kode toko unik atau kosong untuk kode generik.

value

Price

Nilai pesanan minimum untuk toko tertentu.

OnlineReturnPolicy

Objek Kebijakan pengembalian online. Saat ini, kolom ini digunakan untuk menampilkan kebijakan pengembalian untuk iklan dan program listingan gratis.

Kolom
name

string

ID. Nama resource OnlineReturnPolicy. Format: accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Hanya output. ID kebijakan pengembalian yang dibuat oleh Google.

label

string

Wajib. Tidak dapat diubah. Kolom ini mewakili label unik yang ditentukan pengguna untuk kebijakan pengembalian. Perhatikan bahwa label yang sama tidak dapat digunakan dalam kebijakan pengembalian yang berbeda untuk negara yang sama. Kecuali jika produk menentukan atribut label tertentu, kebijakan akan otomatis diberi label sebagai 'default'. Untuk menetapkan kebijakan pengembalian kustom ke grup produk tertentu, ikuti petunjuk yang diberikan di Label kebijakan pengembalian. Label dapat berisi hingga 50 karakter.

countries[]

string

Wajib. Tidak dapat diubah. Negara penjualan tempat kebijakan pengembalian berlaku. Nilai harus berupa kode ISO 3166 2 huruf yang valid.

policy

Policy

Kebijakan pengembalian.

seasonal_overrides[]

SeasonalOverride

Opsional. Penggantian kebijakan umum untuk pesanan yang dilakukan selama serangkaian interval waktu tertentu.

restocking_fee

RestockingFee

Biaya pengisian ulang stok yang berlaku untuk semua kategori alasan pengembalian. Nilai ini akan diperlakukan sebagai biaya pengisian ulang gratis jika nilai tidak ditetapkan.

return_methods[]

ReturnMethod

Metode pengembalian tentang cara pelanggan dapat mengembalikan item. Nilai ini tidak boleh kosong kecuali jika jenis kebijakan pengembalian adalah noReturns.

item_conditions[]

ItemCondition

Kondisi item yang diterima untuk pengembalian tidak boleh kosong, kecuali jika jenis kebijakan pengembalian adalah 'noReturns'.

return_shipping_fee

ReturnShippingFee

Biaya pengiriman pengembalian. Hanya boleh ditetapkan jika pelanggan perlu mendownload dan mencetak label pengembalian.

return_policy_uri

string

Wajib. URI kebijakan pengembalian. Ini dapat digunakan oleh Google untuk melakukan pemeriksaan keandalan kebijakan. URL harus valid.

accept_defective_only

bool

Kolom ini menentukan apakah penjual hanya menerima produk yang rusak untuk pengembalian, dan kolom ini wajib diisi.

process_refund_days

int32

Kolom ini menentukan jumlah hari yang diperlukan penjual untuk memproses pengembalian dana, kolom ini bersifat opsional.

accept_exchange

bool

Kolom ini menentukan apakah penjual mengizinkan pelanggan menukar produk. Kolom ini wajib diisi.

ItemCondition

Kondisi item yang tersedia.

Enum
ITEM_CONDITION_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NEW Baru.
USED Digunakan.

Kebijakan

Kebijakan yang tersedia.

Kolom
type

Type

Jenis kebijakan.

days

int64

Jumlah hari item dapat dikembalikan setelah diterima, dengan satu hari didefinisikan sebagai 24 jam setelah stempel waktu pengiriman. Diperlukan untuk menampilkan NUMBER_OF_DAYS_AFTER_DELIVERY.

Jenis

Jenis kebijakan pengembalian.

Enum
TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NUMBER_OF_DAYS_AFTER_DELIVERY Jumlah hari yang berlaku untuk pengembalian setelah pengiriman.
NO_RETURNS Tidak ada pengembalian barang.
LIFETIME_RETURNS Pengembalian tanpa batas waktu.

RestockingFee

Biaya penyetokan ulang. Biaya ini dapat berupa biaya tetap atau persentase mikro.

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari hal berikut:

fixed_fee

Price

Biaya penyetokan ulang tetap.

micro_percent

int32

Persentase total harga dalam mikro. 15.000.000 berarti 15% dari total harga akan ditagih.

ReturnMethod

Metode pengembalian yang tersedia.

Enum
RETURN_METHOD_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BY_MAIL Kembalikan melalui pos.
IN_STORE Kembalikan di toko.
AT_A_KIOSK Mengembalikan di kios.

ReturnShippingFee

Biaya pengiriman pengembalian. Ini dapat berupa biaya tetap atau boolean untuk menunjukkan bahwa pelanggan membayar biaya pengiriman yang sebenarnya.

Kolom
type

Type

Wajib. Jenis biaya pengiriman pengembalian.

fixed_fee

Price

Jumlah biaya pengiriman pengembalian barang tetap. Nilai ini hanya berlaku jika jenisnya adalah FIXED. Kami akan memperlakukan biaya pengiriman pengembalian sebagai gratis jika jenisnya FIXED dan nilai ini tidak ditetapkan.

Jenis

Jenis biaya pengiriman pengembalian barang.

Enum
TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
FIXED Biaya pengiriman pengembalian barang adalah nilai tetap.
CUSTOMER_PAYING_ACTUAL_FEE Pelanggan akan membayar biaya pengiriman pengembalian yang sebenarnya.

SeasonalOverride

Berikutnya: 5

Kolom
label

string

Wajib. Nama tampilan penggantian musiman ini di Merchant Center.

begin

Date

Wajib. Menentukan rentang tanggal saat penggantian musiman ini berlaku. Awal dan akhir bersifat inklusif dan harus dalam format desimal tanggal, misalnya 20250115. Tanggal penggantian musiman tidak boleh tumpang-tindih.

end

Date

Wajib diisi. tanggal akhir penggantian musiman (inklusif).

policy

Policy

Wajib. Kebijakan pengembalian untuk rentang tanggal yang ditentukan.

PhoneVerificationState

Status verifikasi melalui ponsel.

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
PHONE_VERIFICATION_STATE_VERIFIED Telepon telah diverifikasi.
PHONE_VERIFICATION_STATE_UNVERIFIED Ponsel belum diverifikasi

Program

Menentukan partisipasi dalam program tertentu untuk akun yang ditentukan.

Program menyediakan mekanisme untuk menambahkan fungsi ke akun penjual. Contoh umum dari hal ini adalah program Listingan produk gratis, yang memungkinkan produk dari toko penjual ditampilkan di Google secara gratis.

Kolom
name

string

ID. Nama resource program. Format: accounts/{account}/programs/{program}

documentation_uri

string

Hanya output. URL halaman bantuan Merchant Center yang menjelaskan program.

state

State

Hanya output. Status partisipasi akun dalam program.

active_region_codes[]

string

Hanya output. Wilayah tempat akun berpartisipasi aktif dalam program. Region aktif didefinisikan sebagai region tempat semua persyaratan program yang memengaruhi region tersebut telah terpenuhi.

Kode wilayah ditentukan oleh CLDR. Ini adalah negara tempat program berlaku secara khusus untuk negara tersebut atau 001 jika program berlaku secara global.

unmet_requirements[]

Requirement

Hanya output. Persyaratan yang belum dipenuhi akun yang memengaruhi partisipasi dalam program.

Persyaratan

Menentukan persyaratan yang ditentukan untuk berpartisipasi dalam program.

Kolom
title

string

Hanya output. Nama persyaratan.

documentation_uri

string

Hanya output. URL halaman bantuan yang menjelaskan persyaratan.

affected_region_codes[]

string

Hanya output. Wilayah yang saat ini terpengaruh oleh persyaratan ini yang tidak terpenuhi.

Kode wilayah ditentukan oleh CLDR. Ini adalah negara tempat program berlaku secara khusus untuk negara tersebut atau 001 jika program berlaku secara global.

Negara Bagian

Kemungkinan status partisipasi program untuk akun.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NOT_ELIGIBLE Akun tidak memenuhi syarat untuk berpartisipasi dalam program.
ELIGIBLE Akun tersebut memenuhi syarat untuk berpartisipasi dalam program ini.
ENABLED Program diaktifkan untuk akun.

RateGroup

Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan untuk memiliki applicable_shipping_labels kosong, yang berarti "semua yang lain". applicable_shipping_labels lainnya tidak boleh tumpang-tindih.

Kolom
applicable_shipping_labels[]

string

Wajib. Daftar label paket yang menentukan produk yang menjadi sasaran penerapan grup tarif ini. Ini adalah disjungsi: hanya salah satu label yang harus cocok agar grup tarif dapat diterapkan. Hanya boleh kosong untuk grup tarif terakhir dari suatu layanan.

subtables[]

Table

Opsional. Daftar subtabel yang dirujuk oleh main_table. Hanya dapat ditetapkan jika main_table ditetapkan.

carrier_rates[]

CarrierRate

Opsional. Daftar tarif operator yang dapat dirujuk oleh main_table atau single_value.

single_value

Value

Nilai grup tarif (Misalnya tarif tetap $10). Hanya dapat ditetapkan jika main_table dan subtables tidak ditetapkan.

main_table

Table

Tabel yang menentukan grup tarif, jika single_value tidak cukup ekspresif. Hanya dapat disetel jika single_value tidak disetel.

name

string

Opsional. Nama grup tarif. Jika ditetapkan, harus unik dalam layanan pengiriman.

Wilayah

Merepresentasikan wilayah geografis yang dapat Anda gunakan sebagai target dengan layanan RegionalInventory dan ShippingSettings. Anda dapat menentukan wilayah sebagai kumpulan kode pos atau, di beberapa negara, menggunakan geotarget yang telah ditentukan. Untuk informasi selengkapnya, lihat Menyiapkan region untuk mengetahui informasi selengkapnya.

Kolom
name

string

ID. Nama resource wilayah. Format: accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

Opsional. Daftar kode pos yang menentukan area wilayah.

geotarget_area

GeoTargetArea

Opsional. Daftar geotarget yang menentukan area wilayah.

regional_inventory_eligible

BoolValue

Hanya output. Menunjukkan apakah wilayah memenuhi syarat untuk digunakan dalam konfigurasi Inventaris Regional.

shipping_eligible

BoolValue

Hanya output. Menunjukkan apakah wilayah memenuhi syarat untuk digunakan dalam konfigurasi Layanan Pengiriman.

display_name

string

Opsional. Nama tampilan wilayah.

GeoTargetArea

Daftar geotarget yang menentukan area wilayah.

Kolom
geotarget_criteria_ids[]

int64

Wajib. Daftar ID lokasi yang tidak kosong. Semuanya harus memiliki jenis lokasi yang sama (misalnya, negara bagian).

PostalCodeArea

Daftar kode pos yang menentukan area wilayah. Catatan: Semua wilayah yang ditentukan menggunakan kode pos dapat diakses melalui resource ShippingSettings.postalCodeGroups akun.

Kolom
region_code

string

Wajib. Kode wilayah CLDR atau negara tempat grup kode pos berlaku.

postal_codes[]

PostalCodeRange

Wajib. Rentang kode pos.

PostalCodeRange

Rentang kode pos yang menentukan area wilayah.

Kolom
begin

string

Wajib. Kode pos atau pola dalam bentuk awalan* yang menunjukkan batas bawah inklusif rentang yang menentukan area. Contoh nilai: 94108, 9410*, 9*.

end

string

Opsional. Kode pos atau pola dalam bentuk prefix* yang menunjukkan batas atas inklusif dari rentang yang menentukan area. Panjangnya harus sama dengan postalCodeRangeBegin: jika postalCodeRangeBegin adalah kode pos, maka postalCodeRangeEnd juga harus berupa kode pos; jika postalCodeRangeBegin adalah pola, maka postalCodeRangeEnd harus berupa pola dengan panjang awalan yang sama. Opsional: jika tidak ditetapkan, area akan ditentukan sebagai semua kode pos yang cocok dengan postalCodeRangeBegin.

Wajib

Menjelaskan persyaratan layanan yang harus disetujui.

Kolom
terms_of_service

string

termsOfService yang perlu disetujui.

tos_file_uri

string

URL lengkap ke file persyaratan layanan. Kolom ini sama dengan TermsOfService.file_uri, dan ditambahkan di sini hanya untuk memudahkan.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Pesan permintaan untuk metode RetrieveForApplicationTermsOfServiceAgreementState.

Kolom
parent

string

Wajib. Akun yang akan mendapatkan Format TermsOfServiceAgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Pesan permintaan untuk metode RetrieveLatestTermsOfService.

Kolom
region_code

string

Wajib. Kode wilayah seperti yang ditentukan oleh CLDR. Ini adalah negara jika ToS berlaku secara khusus untuk negara tersebut atau 001 jika berlaku secara global.

kind

TermsOfServiceKind

Wajib. Jenis yang menerapkan versi persyaratan layanan ini.

Baris

Sertakan daftar sel.

Kolom
cells[]

Value

Wajib. Daftar sel yang membentuk baris. Harus memiliki panjang yang sama dengan columnHeaders untuk tabel dua dimensi, panjang 1 untuk tabel satu dimensi.

Layanan

Layanan pengiriman.

Kolom
delivery_countries[]

string

Wajib. Kode wilayah CLDR negara tempat layanan berlaku.

rate_groups[]

RateGroup

Opsional. Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan untuk memiliki applicable_shipping_labels kosong, yang berarti "semua yang lain". applicable_shipping_labels lainnya tidak boleh tumpang-tindih.

loyalty_programs[]

LoyaltyProgram

Opsional. Program loyalitas yang dibatasi untuk layanan pengiriman ini.

service_name

string

Wajib. Nama layanan dalam bentuk bebas. Harus unik dalam akun target.

active

bool

Wajib. Boolean yang mengekspos status aktif layanan pengiriman.

currency_code

string

Kode CLDR mata uang yang berlaku untuk layanan ini. Harus sama dengan harga di grup tarif.

delivery_time

DeliveryTime

Wajib. Waktu yang dihabiskan dalam berbagai aspek mulai dari pemesanan hingga pengiriman produk.

shipment_type

ShipmentType

Jenis lokasi tujuan pengiriman pesanan oleh layanan ini.

minimum_order_value

Price

Nilai pesanan minimum untuk layanan ini. Jika ditetapkan, menunjukkan bahwa pelanggan harus membelanjakan minimal jumlah ini. Semua harga dalam layanan harus memiliki mata uang yang sama. Tidak dapat ditetapkan bersama dengan minimum_order_value_table.

minimum_order_value_table

MinimumOrderValueTable

Tabel nilai pesanan minimum per toko untuk jenis fulfillment pengambilan. Tidak dapat ditetapkan bersama dengan minimum_order_value.

store_config

StoreConfig

Daftar toko tempat produk Anda dikirim. Hal ini hanya berlaku untuk jenis pengiriman pesanan lokal.

LoyaltyProgram

Program loyalitas yang disediakan oleh penjual.

Kolom
loyalty_program_tiers[]

LoyaltyProgramTiers

Opsional. Tingkat program loyalitas layanan pengiriman ini.

program_label

string

Ini adalah label program loyalitas yang ditetapkan di setelan program loyalitas Anda di Merchant Center. Sub-atribut ini memungkinkan Google memetakan program loyalitas Anda ke penawaran yang memenuhi syarat.

LoyaltyProgramTiers

Subkumpulan program loyalitas penjual.

Kolom
tier_label

string

Sub-atribut label tingkat [tier_label] membedakan manfaat level penawaran di antara setiap tingkat. Nilai ini juga ditetapkan di setelan program Anda di Merchant Center, dan diperlukan untuk perubahan sumber data meskipun program loyalitas Anda hanya memiliki 1 tingkat.

ShipmentType

Jenis pengiriman layanan pengiriman.

Enum
SHIPMENT_TYPE_UNSPECIFIED Layanan ini tidak menentukan jenis pengiriman.
DELIVERY Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan.
LOCAL_DELIVERY Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan. Pesanan dikirim dari toko lokal di sekitar.
COLLECTION_POINT Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan. Pesanan dikirim dari lokasi pengambilan.

StoreConfig

Daftar toko tempat produk Anda dikirim. Hal ini hanya berlaku untuk jenis pengiriman pesanan lokal.

Kolom
store_codes[]

string

Opsional. Daftar kode toko yang menyediakan pengiriman lokal. Jika kosong, all_stores harus benar.

store_service_type

StoreServiceType

Menunjukkan apakah semua toko, atau toko tertentu, yang tercantum oleh penjual ini menyediakan pengiriman lokal.

cutoff_config

CutoffConfig

Konfigurasi yang terkait dengan pengiriman lokal berakhir untuk hari itu.

service_radius

Distance

Radius pengiriman maksimum. Hal ini hanya diperlukan untuk jenis pengiriman pengiriman lokal.

CutoffConfig

Konfigurasi yang terkait dengan pengiriman lokal berakhir untuk hari itu.

Kolom
local_cutoff_time

LocalCutoffTime

Waktu pengiriman lokal berakhir untuk hari tersebut.

store_close_offset_hours

int64

Hanya berlaku dengan fulfillment pengiriman lokal. Merepresentasikan waktu batas sebagai jumlah jam sebelum toko tutup. Tidak dapat muncul bersamaan dengan local_cutoff_time.

no_delivery_post_cutoff

bool

Penjual dapat memilih untuk tidak menampilkan pengiriman lokal n+1 hari jika mereka memiliki layanan pengiriman yang dikonfigurasi ke pengiriman lokal n hari. Misalnya, jika layanan pengiriman menentukan pengiriman pada hari yang sama, dan sudah melewati batas waktu, menetapkan kolom ini ke true akan menyebabkan tarif layanan pengiriman yang dihitung menampilkan NO_DELIVERY_POST_CUTOFF. Dalam contoh yang sama, menetapkan kolom ini ke false akan menghasilkan waktu pengiriman yang dihitung menjadi satu hari. Hal ini hanya untuk pengiriman lokal.

LocalCutoffTime

Waktu pengiriman lokal berakhir untuk hari tersebut.

Kolom
hour

int64

Pesanan pengiriman lokal harus dilakukan sebelum jam untuk diproses pada hari yang sama.

minute

int64

Pesanan pengiriman lokal menit harus dilakukan sebelum batas waktu untuk diproses pada hari yang sama.

StoreServiceType

Menunjukkan apakah semua toko, atau toko tertentu, yang tercantum oleh penjual menyediakan pengiriman lokal.

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Tidak menentukan jenis layanan toko.
ALL_STORES Menunjukkan apakah semua toko, saat ini dan mendatang, yang tercantum oleh penjual ini menyediakan pengiriman lokal.
SELECTED_STORES Menunjukkan bahwa hanya toko yang tercantum di store_codes yang memenuhi syarat untuk pengiriman lokal.

ShippingSettings

Setelan pengiriman akun penjual.

Kolom
name

string

ID. Nama resource setelan pengiriman. Format: accounts/{account}/shippingSetting

services[]

Service

Opsional. Daftar layanan akun target.

warehouses[]

Warehouse

Opsional. Daftar gudang yang dapat dirujuk di services.

etag

string

Wajib. Kolom ini digunakan untuk menghindari masalah asinkron. Pastikan data setelan pengiriman tidak berubah antara panggilan get dan panggilan insert. Pengguna harus melakukan langkah-langkah berikut:

  1. Tetapkan kolom etag sebagai string kosong untuk pembuatan setelan pengiriman awal.

  2. Setelah pembuatan awal, panggil metode get untuk mendapatkan etag dan data setelan pengiriman saat ini sebelum menyisipkan panggilan.

  3. Ubah ke informasi setelan pengiriman yang diinginkan.

  4. Panggil metode penyisipan dengan informasi setelan pengiriman yang diinginkan dengan etag yang diperoleh dari langkah 2.

  5. Jika data setelan pengiriman berubah antara langkah 2 dan langkah 4. Permintaan penyisipan akan gagal karena etag berubah setiap kali data setelan pengiriman berubah. Pengguna harus mengulangi langkah 2-4 dengan etag baru.

Tabel

Tabel yang menentukan grup tarif, jika single_value tidak cukup ekspresif.

Kolom
rows[]

Row

Wajib. Daftar baris yang membentuk tabel. Harus sama panjang dengan row_headers.

name

string

Nama tabel. Diperlukan untuk subtabel, diabaikan untuk tabel utama.

row_headers

Headers

Wajib. Header baris tabel.

column_headers

Headers

Header kolom tabel. Opsional: jika tidak ditetapkan, tabel hanya memiliki satu dimensi.

TermsOfService

Pesan TermsOfService mewakili versi tertentu dari persyaratan layanan yang harus disetujui penjual untuk mengakses fitur atau layanan tertentu (lihat https://support.google.com/merchants/answer/160173).

Pesan ini penting untuk proses aktivasi, yang memastikan bahwa penjual menyetujui perjanjian hukum yang diperlukan untuk menggunakan layanan. Penjual dapat mengambil persyaratan layanan terbaru untuk kind dan region tertentu melalui RetrieveLatestTermsOfService, dan menyetujuinya sebagaimana diwajibkan melalui AcceptTermsOfService.

Kolom
name

string

ID. Nama resource versi persyaratan layanan. Format: termsOfService/{version}

region_code

string

Kode wilayah seperti yang ditentukan oleh CLDR. Ini adalah negara tempat ToS berlaku secara khusus untuk negara tersebut atau 001 jika TermsOfService yang sama dapat ditandatangani di negara mana pun. Namun, perlu diperhatikan bahwa saat menandatangani ToS yang berlaku secara global, kami tetap mengharapkan negara tertentu diberikan (negara ini harus berupa negara bisnis penjual atau negara partisipasi program).

kind

TermsOfServiceKind

Jenis yang menerapkan versi persyaratan layanan ini.

external

bool

Apakah versi persyaratan layanan ini bersifat eksternal. Versi persyaratan layanan eksternal hanya dapat disetujui melalui proses eksternal dan bukan langsung oleh penjual melalui UI atau API.

file_uri

string

URI untuk file persyaratan layanan yang perlu ditampilkan kepada pengguna yang menandatangani.

TermsOfServiceAgreementState

Resource ini mewakili status perjanjian untuk akun tertentu dan jenis persyaratan layanan. Statusnya adalah sebagai berikut:

  • Jika penjual telah menyetujui persyaratan layanan: accepted akan diisi, jika tidak, kolom ini akan kosong
  • Jika penjual harus menandatangani persyaratan layanan: wajib akan diisi, jika tidak, kolom ini akan kosong.

Perhatikan bahwa required dan accepted dapat ada. Dalam hal ini, persyaratan layanan accepted akan memiliki tanggal habis masa berlaku yang ditetapkan di kolom valid_until. Persyaratan layanan required harus disetujui sebelum valid_until agar akun dapat terus memiliki perjanjian yang valid. Saat menyetujui persyaratan layanan baru, kami mengharapkan pihak ketiga menampilkan teks yang terkait dengan perjanjian persyaratan layanan yang diberikan (URL ke file yang berisi teks ditambahkan dalam pesan Wajib di bawah sebagai tos_file_uri. Persetujuan persyaratan layanan yang sebenarnya dilakukan dengan memanggil accept pada resource TermsOfService.

Kolom
name

string

ID. Nama resource versi persyaratan layanan. Format: accounts/{account}/termsOfServiceAgreementState/{identifier} Format ID adalah: {TermsOfServiceKind}-{country} Misalnya, ID dapat berupa: MERCHANT_CENTER-US

region_code

string

Kode wilayah seperti yang ditentukan oleh https://cldr.unicode.org/. Ini adalah negara tempat status saat ini berlaku.

terms_of_service_kind

TermsOfServiceKind

Jenis Persyaratan Layanan yang terkait dengan versi tertentu.

accepted

Accepted

Persyaratan layanan yang disetujui dari jenis ini dan untuk region_code terkait

required

Required

Persyaratan layanan yang diperlukan

TermsOfServiceKind

Jenis TermsOfService.

Enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
MERCHANT_CENTER Aplikasi Merchant Center.

TransitTable

Tabel waktu transit, jumlah hari kerja yang dihabiskan dalam transit berdasarkan dimensi baris dan kolom. min_transit_days, max_transit_days, atau transit_time_table dapat ditetapkan, tetapi tidak keduanya.

Kolom
postal_code_group_names[]

string

Wajib. Daftar nama region Region.name . Nilai terakhir dapat berupa "all other locations". Contoh: ["zone 1", "zone 2", "all other locations"]. Grup kode pos yang dirujuk harus cocok dengan negara pengiriman layanan.

transit_time_labels[]

string

Wajib. Daftar label waktu transit. Nilai terakhir dapat berupa "all other labels". Contoh: ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Wajib. Jika hanya ada satu kumpulan dimensi postal_code_group_names atau transit_time_labels, ada beberapa baris yang masing-masing memiliki satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postal_code_group_names, dan kolom (nilai) sesuai dengan transit_time_labels.

TransitTimeRow

Jika hanya ada satu kumpulan dimensi postal_code_group_names atau transit_time_labels, ada beberapa baris yang masing-masing memiliki satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postal_code_group_names, dan kolom (nilai) sesuai dengan transit_time_labels.

Kolom
values[]

TransitTimeValue

Wajib. Rentang waktu transit (min-maks) dalam hari kerja.

TransitTimeValue

Rentang waktu transit (min-maks) dalam hari kerja.

Kolom
min_transit_days

int32

Rentang waktu transit minimum dalam hari kerja. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya.

max_transit_days

int32

Harus lebih besar dari atau sama dengan min_transit_days.

UnclaimHomepageRequest

Pesan permintaan untuk metode UnclaimHomepage.

Kolom
name

string

Wajib. Nama halaman beranda yang akan dibatalkan klaimnya. Format: accounts/{account}/homepage

UpdateAccountRequest

Pesan permintaan untuk metode UpdateAccount.

Kolom
account

Account

Wajib. Versi baru akun.

update_mask

FieldMask

Opsional. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

Pesan permintaan untuk metode UpdateAutofeedSettings.

Kolom
autofeed_settings

AutofeedSettings

Wajib. Versi baru setelan feed otomatis.

update_mask

FieldMask

Wajib. Daftar kolom yang diperbarui.

UpdateBusinessIdentityRequest

Pesan permintaan untuk metode UpdateBusinessIdentity.

Kolom
business_identity

BusinessIdentity

Wajib. Versi baru identitas bisnis.

update_mask

FieldMask

Opsional. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

Pesan permintaan untuk metode UpdateBusinessInfo.

Kolom
business_info

BusinessInfo

Wajib. Versi baru info bisnis.

update_mask

FieldMask

Opsional. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

Pesan permintaan untuk metode UpdateEmailPreferences.

Kolom
email_preferences

EmailPreferences

Wajib. Preferensi Email akan diperbarui.

update_mask

FieldMask

Wajib. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

Pesan permintaan untuk metode UpdateHomepage.

Kolom
homepage

Homepage

Wajib. Versi baru halaman beranda.

update_mask

FieldMask

Opsional. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • uri

UpdateRegionRequest

Pesan permintaan untuk metode UpdateRegion.

Kolom
region

Region

Wajib. Wilayah yang diperbarui.

update_mask

FieldMask

Opsional. Mask kolom yang dipisahkan koma yang menunjukkan kolom yang akan diperbarui. Contoh: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Pesan permintaan untuk metode UpdateUser.

Kolom
user

User

Wajib. Versi baru pengguna.

Gunakan me untuk merujuk ke alamat email Anda sendiri, misalnya accounts/{account}/users/me.

update_mask

FieldMask

Opsional. Daftar kolom yang diperbarui.

Kolom berikut didukung (baik di snake_case maupun lowerCamelCase):

  • access_rights

Pengguna

Pesan User mewakili pengguna yang terkait dengan akun Merchant Center. Izin ini digunakan untuk mengelola izin pengguna dan hak akses dalam akun. Untuk informasi selengkapnya, lihat Pertanyaan umum (FAQ) tentang pengguna dan tingkat akses.

Kolom
name

string

ID. Nama resource pengguna. Format: accounts/{account}/user/{email}

Gunakan me untuk merujuk ke alamat email Anda sendiri, misalnya accounts/{account}/users/me.

state

State

Hanya output. Status pengguna.

access_rights[]

AccessRight

Opsional. Hak akses yang dimiliki pengguna.

Negara Bagian

Status yang mungkin dimiliki pengguna.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
PENDING Pengguna menunggu konfirmasi. Dalam status ini, pengguna harus menerima undangan terlebih dahulu sebelum melakukan tindakan lain.
VERIFIED Pengguna telah diverifikasi.

Nilai

Satu nilai grup tarif atau nilai sel tabel grup tarif. Salah satu dari no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name harus ditetapkan.

Kolom
no_shipping

bool

Jika benar, produk tidak dapat dikirim. Harus benar saat ditetapkan, hanya dapat ditetapkan jika semua kolom lain tidak ditetapkan.

flat_rate

Price

Tarif tetap. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

price_percentage

string

Persentase harga yang direpresentasikan sebagai angka dalam notasi desimal (Misalnya, "5.4"). Hanya dapat ditetapkan jika semua kolom lain tidak ditetapkan.

carrier_rate

string

Nama tarif ekspedisi yang merujuk pada tarif ekspedisi yang ditentukan dalam grup tarif yang sama. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.

subtable

string

Nama subtabel. Hanya dapat ditetapkan di sel tabel (Misalnya, bukan untuk nilai tunggal), dan hanya jika semua kolom lainnya tidak ditetapkan.

Gudang

Gudang fulfillment, yang menyimpan dan menangani inventaris.

Kolom
name

string

Wajib. Nama gudang. Harus unik dalam akun.

shipping_address

Address

Wajib. Alamat pengiriman gudang.

cutoff_time

WarehouseCutoffTime

Wajib. Waktu terakhir pesanan dapat diterima dan mulai diproses. Pesanan yang dilakukan nanti akan diproses pada hari berikutnya. Waktunya didasarkan pada kode pos gudang.

handling_days

int64

Wajib. Jumlah hari yang diperlukan gudang ini untuk mengemas dan mengirimkan item. Hal ini dilakukan di tingkat gudang, tetapi dapat diganti di tingkat penawaran berdasarkan atribut item.

business_day_config

BusinessDayConfig

Hari kerja gudang. Jika tidak ditetapkan, hari kerja defaultnya adalah Senin hingga Jumat.

WarehouseBasedDeliveryTime

Menunjukkan bahwa waktu pengiriman harus dihitung per gudang (lokasi asal pengiriman) berdasarkan setelan ekspedisi yang dipilih. Jika ditetapkan, tidak ada kolom terkait waktu transit lain di delivery_time yang boleh ditetapkan.

Kolom
carrier

string

Wajib. Operator, seperti "UPS" atau "Fedex". operator yang didukung

carrier_service

string

Wajib. Layanan operator, seperti "ground" atau "2 days". Nama layanan harus ada dalam daftar eddSupportedServices.

warehouse

string

Wajib. Nama gudang. Ini harus cocok dengan [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

Waktu terakhir pesanan dapat diterima dan mulai diproses. Pesanan yang dilakukan nanti akan diproses pada hari berikutnya. Waktunya didasarkan pada kode pos gudang.

Kolom
hour

int32

Wajib. Jam batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama oleh gudang. Jam didasarkan pada zona waktu gudang.

minute

int32

Wajib. Menit batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama oleh gudang. Menit didasarkan pada zona waktu gudang.