Package google.shopping.merchant.accounts.v1beta

Indeks

AccountIssueService

Layanan untuk mendukung AccountIssueService API.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Mencantumkan semua masalah akun pada akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AccountTaxService

Mengelola data setelan pajak tingkat akun.

API ini menentukan model resource berikut:

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

Menampilkan aturan pajak yang cocok dengan kondisi GetAccountTaxRequest

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

Mencantumkan setelan pajak sub-akun hanya di akun Merchant Center. Metode ini hanya dapat dipanggil di akun multiklien, jika tidak, akan terjadi error.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

Memperbarui setelan pajak akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Menghapus akun yang ditentukan apa pun jenisnya: mandiri, MCA, atau sub-akun. Jika MCA dihapus, semua sub-akunnya akan terhapus. Untuk menjalankan metode ini, Anda memerlukan akses admin.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Mengambil akun dari akun Merchant Center Anda. Setelah memasukkan, memperbarui, atau menghapus akun, mungkin diperlukan waktu beberapa menit sebelum perubahan dapat diterapkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Mencantumkan akun yang dapat diakses oleh pengguna yang menelepon dan cocok dengan batasan permintaan, seperti ukuran halaman atau filter. Daftar ini tidak hanya mencantumkan sub-akun MCA, tetapi semua akun yang dapat diakses oleh pengguna yang melakukan panggilan, termasuk MCA lainnya, akun tertaut, akun mandiri, dan sebagainya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BusinessIdentityService

Layanan untuk mendukung API identitas bisnis.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Mengambil identitas bisnis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BusinessInfoService

Layanan untuk mendukung API info bisnis.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Mengambil info bisnis akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

EmailPreferencesService

Layanan untuk mendukung EmailPreferences API.

Layanan ini hanya mengizinkan pengambilan dan pembaruan preferensi email untuk pengguna yang diautentikasi.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Menampilkan preferensi email untuk pengguna akun Merchant Center.

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 dalam mask update tidak akan diperbarui.

Menentukan nilai status keikutsertaan UNCONFIRMED tidak valid.

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

HomepageService

Layanan untuk mendukung API di halaman beranda toko.

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, hal ini akan menampilkan error, tetapi tidak akan menghapus klaim. Jika gagal, pesan error kanonis akan ditampilkan: * PERMISSION_DENIED: pengguna tidak memiliki izin yang diperlukan untuk akun MC ini; * FAILED_PRECONDITION: - Akun tersebut 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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Mengambil halaman beranda toko.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

OnlineReturnPolicyService

Layanan ini memfasilitasi pengelolaan konfigurasi kebijakan pengembalian karena penyesalan oleh 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.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Mencantumkan semua kebijakan pengembalian yang ada.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ProgramsService

Layanan untuk pengelolaan program.

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

Layanan ini memaparkan 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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Mengambil program yang ditentukan untuk akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Mengambil semua program untuk akun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

RegionsService

Mengelola konfigurasi region.

API ini menentukan model resource berikut:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Mengambil wilayah yang ditentukan di akun Merchant Center Anda.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Mencantumkan wilayah di akun Merchant Center Anda.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

TermsOfServiceAgreementStateService

Layanan untuk mendukung TermsOfServiceAgreementState API.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Menampilkan status perjanjian persyaratan layanan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Mengambil status perjanjian untuk persyaratan layanan aplikasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Mengambil TermsOfService yang terkait dengan versi yang disediakan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Mengambil versi terbaru TermsOfService untuk kind dan region_code tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
GetUser

rpc GetUser(GetUserRequest) returns (User)

Mengambil pengguna akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Menampilkan daftar semua pengguna akun Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
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 ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AcceptTermsOfServiceRequest

Pesan permintaan untuk metode AcceptTermsOfService.

Kolom
name

string

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

string

Wajib. Akun yang akan menerima ToS.
region_code

string

Wajib. Kode wilayah seperti yang ditetapkan oleh CLDR. Ini bisa berupa negara ketika ToS berlaku secara khusus untuk negara tersebut atau 001 jika berlaku secara global.

Diterima

Menjelaskan persyaratan layanan yang diterima.

Kolom
terms_of_service

string

termsOfService yang diterima.
accepted_by

string

Akun tempat penerimaan dicatat. Ini dapat berupa akun itu sendiri atau, untuk sub-akun, akun MCA.
valid_until

Date

Jika ditetapkan, ketentuan ini menyatakan bahwa TermsOfService yang diterima hanya berlaku hingga akhir tanggal ini (dalam UTC). Dokumen baru harus disetujui sebelum tanggal tersebut. Informasi TermsOfService wajib ada dalam pesan Wajib.

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

Akun.

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 informasi selengkapnya.
adult_content

bool

Apakah akun ini berisi konten khusus dewasa.
test_account

bool

Hanya output. Apakah ini akun pengujian.
time_zone

TimeZone

Wajib. Zona waktu akun.

Saat operasi tulis, time_zone menetapkan reporting_time_zone dan display_time_zone.

Untuk pembacaan, time_zone selalu menampilkan display_time_zone. Jika display_time_zone tidak ada untuk akun Anda, time_zone kosong.
language_code

string

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

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 terhadap tujuan.

Kolom
impacts[]

Impact

Dampak (negatif) untuk berbagai wilayah di tujuan tertentu.
reporting_context

ReportingContextEnum

Konteks pelaporan yang terpengaruh.

Dampak

Dampak masalah terhadap suatu wilayah.

Kolom
region_code

string

Kode wilayah CLDR tempat masalah ini terjadi.
severity

Severity

Tingkat keparahan masalah di tujuan dan region.

Tingkat keparahan

Semua kemungkinan tingkat keparahan masalah.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak diketahui.
CRITICAL Masalah ini menyebabkan penawaran tidak ditayangkan.
ERROR Masalah ini dapat memengaruhi penawaran (di masa mendatang) atau mungkin menjadi indikator adanya masalah dengan penawaran.
SUGGESTION Masalah ini merupakan saran untuk perbaikan.

AccountTax

Setelan pajak akun penjual. Semua metode memerlukan peran admin.

Kolom
name

string

ID. Nama setelan pajak. Format: "{account_tax.name=accounts/{account}}"
account

int64

Hanya output. ID akun yang mencakup setelan pajak akun ini.
tax_rules[]

TaxRule

Peraturan pajak. "Tentukan aturan pajak di setiap wilayah. Pajak tidak akan ditampilkan jika suatu wilayah tidak memiliki aturan."

Alamat

Alamat pengiriman gudang.

Kolom
street_address

string

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

string

Wajib. Kota besar, kota kecil, atau komune. Juga dapat mencakup lokalitas atau sublokalitas dependen (Misalnya kawasan atau pinggiran kota).
administrative_area

string

Wajib. Subdivisi administratif tingkat teratas di negara tersebut. Misalnya, negara bagian seperti California ("CA") atau provinsi seperti Quebec ("QC").
postal_code

string

Wajib. Kode pos atau kode pos (misalnya "94043").
region_code

string

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

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

Pengumpulan 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 dirinya 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 teridentifikasi dengan atribut.

PromotionsConsent

Semua kemungkinan setelan terkait promosi yang terkait dengan identitas bisnis.

Enum

BusinessInfo

Pengumpulan informasi yang terkait dengan bisnis.

Kolom
name

string

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

PostalAddress

Opsional. Alamat bisnis.
phone

PhoneNumber

Opsional. Nomor telepon bisnis.
phone_verification_state

PhoneVerificationState

Hanya output. Status verifikasi telepon bisnis.
customer_service

CustomerService

Opsional. Layanan pelanggan bisnis.

CarrierRate

Daftar tarif ekspedisi yang dapat dirujuk oleh main_table atau single_value.

Kolom
name

string

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

string

Wajib. Layanan ekspedisi, seperti "UPS" atau "Fedex".
carrier_service

string

Wajib. Layanan ekspedisi, seperti "ground" atau "2 days".
origin_postal_code

string

Wajib. Asal pengiriman untuk tarif ekspedisi ini.
percentage_adjustment

string

Opsional. Pengubah tarif pengiriman perkalian sebagai angka dalam notasi desimal. Bisa negatif. Misalnya, "5.4" meningkatkan rasio sebesar 5,4%, "-3" menurunkan rasio tersebut sebesar 3%.
flat_adjustment

Price

Opsional. Pengubah tarif pengiriman tambahan. Bisa 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

CreateAndConfigureAccountRequest

Pesan permintaan untuk metode CreateAndConfigureAccount.

Kolom
account

Account

Wajib. Akun yang akan dibuat.
users[]

CreateUserRequest

Opsional. Pengguna yang akan ditambahkan ke akun.
service[]

AddAccountService

Opsional. Jika ditentukan, layanan akun antara akun yang akan dibuat dan akun penyedia akan diinisialisasi sebagai bagian dari pembuatan.
accept_terms_of_service

AcceptTermsOfService

Opsional. Persyaratan Layanan (ToS) yang akan segera disetujui setelah pembuatan akun.

AcceptTermsOfService

Referensi ke resource Persyaratan Layanan.

Kolom
name

string

Wajib. Nama resource versi persyaratan layanan.
region_code

string

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

AddAccountService

Petunjuk tambahan untuk menambahkan layanan akun selama pembuatan akun.

Kolom
Kolom union service_type. Saat ini hanya mendukung jenis akun induk Multiklien. service_type hanya dapat berupa salah satu dari yang berikut:
account_aggregation

Empty

Penyedia merupakan agregator untuk akun.
provider

string

Opsional. Penyedia layanan. Format: accounts/{account}

CreateRegionRequest

Pesan permintaan untuk metode CreateRegion.

Kolom
parent

string

Wajib. Akun untuk membuat wilayah. Format: accounts/{account}
region_id

string

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

Region

Wajib. Region yang akan dibuat.

CreateUserRequest

Pesan permintaan untuk metode CreateUser.

Kolom
parent

string

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

string

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

User

Wajib. 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 batas waktu hari kerja.

Kolom
hour

int32

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

int32

Wajib. Menit batas waktu hingga pesanan harus 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}

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 lain di [waktu pengiriman][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] yang harus ditetapkan.
min_transit_days

int32

Jumlah hari kerja minimum yang dihabiskan untuk transit. 0 berarti pengiriman di hari yang sama, 1 berarti pengiriman di hari berikutnya. min_transit_days, max_transit_days, atau transit_time_table harus ditetapkan, tetapi jangan keduanya.
max_transit_days

int32

Jumlah maksimum hari kerja yang dihabiskan untuk transit. 0 berarti pengiriman di hari yang sama, 1 berarti pengiriman di hari berikutnya. Harus lebih besar dari atau sama dengan min_transit_days.
cutoff_time

CutoffTime

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

int32

Jumlah hari kerja minimum yang dihabiskan sebelum pesanan dikirimkan. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya.
max_handling_days

int32

Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirimkan. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. Harus lebih besar dari atau sama dengan min_handling_days.
transit_time_table

TransitTable

Tabel waktu transit, jumlah hari kerja yang dihabiskan untuk 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 untuk menangani pesanan. Jika tidak diberikan, hari kerja akan dianggap sebagai hari kerja Senin hingga Jumat.
transit_business_day_config

BusinessDayConfig

Hari kerja saat pesanan dapat berada dalam pengiriman. Jika tidak diberikan, hari kerja akan dianggap sebagai hari kerja Senin hingga Jumat.

DisableProgramRequest

Pesan permintaan untuk metode DisableProgram.

Kolom
name

string

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

Jarak

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

Kolom
value

int64

Nilai jarak bilangan bulat.
unit

Unit

Unit dapat berbeda berdasarkan negara, diparameterisasi untuk menyertakan mil dan kilometer.

Unit

Unit dapat berbeda berdasarkan negara, diparameterisasi untuk menyertakan mil dan kilometer.

Enum
UNIT_UNSPECIFIED Unit belum ditetapkan
MILES Unit dalam mil
KILOMETERS Satuan dalam kilometer

EmailPreferences

Kategori notifikasi yang diikuti / tidak diikutsertakan oleh pengguna. Preferensi email tidak menyertakan pengumuman wajib karena pengguna tidak dapat memilih untuk tidak menerima pengumuman tersebut.

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

Mengikutsertakan status preferensi email.

Enum
OPT_IN_STATE_UNSPECIFIED Status keikutsertaan tidak ditentukan.
OPTED_OUT Pengguna telah 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 keikutsertaan (hanya berlaku untuk negara tertentu).

EnableProgramRequest

Pesan permintaan untuk metode EnableProgram.

Kolom
name

string

Wajib. Nama program yang akan mengaktifkan partisipasi untuk akun yang ditentukan. Format: accounts/{account}/programs/{program}

GetAccountRequest

Pesan permintaan untuk metode GetAccount.

Kolom
name

string

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

GetAccountTaxRequest

Permintaan untuk mendapatkan setelan pajak

Kolom
name

string

Wajib. Nama setelan pajak yang akan diambil

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 region 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}

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 di 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 menjadi tak terhingga dengan menetapkan price 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 lain belum ditetapkan.
weights[]

Weight

Wajib. Daftar batas atas berat pesanan inklusif. Nilai bobot terakhir dapat menjadi tak terhingga 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 lain belum ditetapkan.
number_of_items[]

string

Wajib. Daftar batas atas jumlah inklusif item. Nilai terakhir dapat berupa "infinity". Misalnya, ["10", "50", "infinity"] mewakili header "<= 10 items", "<= 50 items", dan "> 50 items". Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lain belum 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 lain belum ditetapkan.
locations[]

LocationIdSet

Wajib. Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan.

Halaman Beranda

Halaman beranda toko.

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) dari halaman beranda toko.

InsertShippingSettingsRequest

Pesan permintaan untuk metode InsertShippingSetting.

Kolom
parent

string

Wajib. Akun tempat produk ini akan dimasukkan. 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, yang diterima dari panggilan ListAccountIssues sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListAccountIssues harus cocok dengan panggilan yang menyediakan token halaman.
language_code

string

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

TimeZone

Opsional. Zona waktu IANA yang digunakan untuk melokalkan waktu dalam kolom yang dapat dibaca manusia. Misalnya 'America/Los_Angeles'. Jika tidak disetel, '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 ada halaman berikutnya.

ListAccountTaxRequest

Permintaan untuk mencantumkan semua setelan pajak sub-akun hanya untuk penjual yang meminta. Metode ini hanya dapat dipanggil di akun multiklien, jika tidak, akan terjadi error.

Kolom
parent

string

Wajib. Induk, yang memiliki penarikan pajak akun ini. Format: accounts/{account}
page_size

int32

Jumlah maksimum setelan pajak yang akan ditampilkan dalam respons, yang digunakan untuk paging.
page_token

string

Token yang ditampilkan oleh permintaan sebelumnya.

ListAccountTaxResponse

Tanggapan atas permintaan daftar pajak akun Metode ini hanya dapat dipanggil di akun multiklien. Jika tidak, metode ini akan menghasilkan error.

Kolom
account_taxes[]

AccountTax

Halaman setelan pajak akun
next_page_token

string

Token untuk pengambilan halaman berikutnya dari setelan pajak akun.

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, yang diterima dari panggilan ListAccounts sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListAccounts harus cocok dengan panggilan yang menyediakan token halaman.
filter

string

Opsional. Filter opsional untuk hanya menampilkan akun yang cocok dengan filter.

Berikut beberapa contoh filter yang valid:

  • accountName = "*store*" AND relationship(providerId = 123)
  • relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
  • (accountName = "storeA") OR (accountName = "storeB")
  • relationship(service( handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
  • relationship(callerHasAccessToProvider() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
  • (relationship(service(type = "ACCOUNT_MANAGEMENT") AND service(handshakeState = "PENDING"))) OR (accountName = "store" AND relationship(...))

Filter di tingkat akun memiliki semantik berikut:

  • accountName Ini mengacu pada kolom accountName di akun.
  • relationship(...) Ini mengacu pada hubungan antara akun dan akun lain. Di dalam fungsi, hubungan ini dapat ditentukan lebih lanjut.

Filter di tingkat relationship memiliki semantik berikut:

  • providerId Ini mengacu pada ID numerik akun yang merupakan anggota lain dari hubungan. Misalnya jika filter harus dibatasi pada akun yang memiliki hubungan dengan akun accounts/name/123, providerId harus difilter sebagai providerId = 123.
  • callerHasAccessToProvider() Tindakan ini akan membatasi akun yang dihasilkan ke akun yang memiliki hubungan dengan akun lain yang juga memiliki akses ke anggota hubungan lainnya (atau penyedia) bagi pengguna yang melakukan panggilan.
  • externalAccountId Ini mengacu ke ID akun eksternal yang dikonfigurasi untuk hubungan tersebut.
  • accountIdAlias Ini mengacu ke alias ID akun yang dikonfigurasi untuk hubungan tersebut.
  • service(...) Ini mengacu pada layanan yang disediakan sebagai bagian dari hubungan. Catatan: Hubungan antara dua akun dapat terdiri dari beberapa layanan.

Filter di tingkat layanan memiliki semantik berikut:

  • handshakeState Ini mengacu pada status handshake layanan. Layanan yang sudah mapan terkadang perlu disetujui oleh anggota yang lain atau kedua pihak terlebih dahulu. Oleh karena itu, layanan dapat berada dalam status PENDING atau APPROVED.
  • type Ini mengacu pada jenis layanan. Kemungkinan nilainya adalah:
    • ACCOUNT_MANAGEMENT Penyedia mengelola akun.
    • ACCOUNT_AGGREGATION Penyedia merupakan agregator akun.

Filter mengikuti subset spesifikasi filter AI dan tata bahasa EBNF formal. Tata bahasa untuk filter ini lebih ketat dan spesifik

filter
    : accountFilterDisj
    | accountFilterConj
    ;
accountFilterDisj
    : "(" accountFilterConj " OR " accountFilterConj ")"
    ;
accountFilterConj
    : accountFilter {" AND " accountFilter}
    ;
accountFilter
    : accountNameFilter | relationshipFn
    ;
accountNameFilter
    : "accountName" comparator value
    ;
relationshipFn
    : "relationship(" relationshipConj ")"
    ;
relationshipConj
    : relationshipFilter {" AND " relationshipFilter}
    ;
relationshipFilter
    : "providerId = " numValue
    | "callerHasAccessToProvider()"
    | "externalAccountId" comparator value
    | "accountIdAlias" comparator value
    | serviceFn
    ;
serviceFn
    : "service(" serviceConj ")"
    ;
serviceConj
    : serviceFilter {" AND " serviceFilter}
    ;
serviceFilter
    : handshakeStateFilter
    | typeFilter
    ;
handshakeStateFilter
    : "handshakeState = " value
    ;
typeFilter
    : "type = " value
    ;
comparator
    : " = " | " != "
    ;

Selain itu, hal berikut berlaku:

  • Setiap kolom dalam hubungan hanya dapat muncul sekali (misalnya, Anda hanya dapat memfilter accountName sekali di tingkat akun atau Anda hanya dapat memfilter providerId sekali di setiap tingkat hubungan).
  • Untuk kolom string (seperti accountName atau accountIdAlias), Anda dapat menyatakan operator CONTAINS dengan menyertakan kueri di *. Misalnya, accountName = "*foo*" akan menampilkan semua akun dengan accountName yang berisi foo. Secara ortogonal, operator NOT_CONTAINS dapat dinyatakan menggunakan !=. Misalnya, accountName != "*foo*" akan menampilkan semua akun dengan accountName yang tidak berisi foo. Catatan: Anda dapat menelusuri akun dengan accountName yang berisi karakter bintang * menggunakan ***.
  • Spasi kosong tambahan akan diabaikan.
  • Semua nilai kecuali untuk nilai yang hanya bersifat numerik harus diapit dengan tanda kutip ganda.
  • Jika disjungsi digunakan, konjungsi di setiap sisi harus menggunakan tanda kurung meskipun kata konjungsi tersebut hanya memiliki satu ekspresi. Tanda kurung tidak diizinkan di tempat lain kecuali untuk pemanggilan fungsi (seperti relationship atau service). Hal ini untuk menyatakan dengan jelas bahwa konjungsi mengikat lebih kuat daripada disjungsi secara logis.

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 ada halaman berikutnya.

ListOnlineReturnPoliciesRequest

Pesan permintaan untuk metode ListOnlineReturnPolicies.

Kolom
parent

string

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

int32

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

string

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

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListOnlineReturnPolicies harus cocok dengan panggilan yang menyediakan token halaman. Token ditampilkan sebagai nextPageToken sebagai 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 ada halaman berikutnya.

ListProgramsRequest

Pesan permintaan untuk metode ListPrograms.

Kolom
parent

string

Wajib. Nama akun untuk mengambil semua program. Format: accounts/{account}
page_size

int32

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

string

Opsional. Token kelanjutan, diterima dari panggilan ListPrograms sebelumnya. Berikan atribut 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 ada halaman berikutnya.

ListRegionsRequest

Pesan permintaan untuk metode ListRegions.

Kolom
parent

string

Wajib. Akun untuk mencantumkan wilayah. Format: accounts/{account}
page_size

int32

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

string

Opsional. Token halaman, yang diterima dari panggilan ListRegions sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListRegions harus cocok 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 ada halaman berikutnya.

ListSubAccountsRequest

Pesan permintaan untuk metode ListSubAccounts.

Kolom
provider

string

Wajib. Akun orang tua. Format: accounts/{account}
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, yang diterima dari panggilan ListAccounts sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListAccounts harus cocok dengan panggilan yang menyediakan token halaman.

ListSubAccountsResponse

Pesan respons untuk metode ListSubAccounts.

Kolom
accounts[]

Account

Akun yang akun induk tertentunya merupakan agregator.
next_page_token

string

Token, yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak 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, yang diterima dari panggilan ListUsers sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Saat memberi nomor halaman, semua parameter lain yang diberikan ke ListUsers harus cocok 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 ada halaman berikutnya.

LocationIdSet

Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lain belum 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 pemenuhan pesanan pengambilan.

Kolom
store_code_set_with_movs[]

StoreCodeSetWithMov

Wajib. Daftar set kode toko dengan nilai pesanan minimum (MOV) yang sama. Setidaknya dua kumpulan diperlukan dan kumpulan terakhir harus kosong, yang menandakan 'MOV for all other store'. Setiap kode toko hanya dapat muncul sekali di semua kumpulan. Semua harga dalam layanan harus memiliki mata uang yang sama.

StoreCodeSetWithMov

Daftar set kode toko dengan nilai pesanan minimum yang sama. Setidaknya dua kumpulan diperlukan dan kumpulan terakhir harus kosong, yang menandakan 'MOV for all other store'. Setiap kode toko hanya dapat muncul sekali di semua kumpulan. Semua harga dalam layanan harus memiliki mata uang yang sama.

Kolom
store_codes[]

string

Opsional. Daftar kode toko unik atau kosong untuk semua.
value

Price

Nilai pesanan minimum untuk toko tertentu.

OnlineReturnPolicy

Objek Online return policy. Saat ini, nomor tersebut digunakan untuk merepresentasikan kebijakan pengembalian untuk program iklan dan 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

Kolom ini mewakili label unik yang ditentukan pengguna untuk kebijakan pengembalian. Penting untuk diperhatikan bahwa label yang sama tidak dapat digunakan di kebijakan pengembalian yang berbeda untuk negara yang sama. Kebijakan akan otomatis diberi label 'default' kecuali jika produk menentukan atribut label tertentu. Untuk menetapkan kebijakan pengembalian khusus untuk kelompok produk tertentu, ikuti petunjuk yang diberikan di Label kebijakan pengembalian. Label dapat berisi hingga 50 karakter.
countries[]

string

Negara penjualan tempat kebijakan pengembalian berlaku. Nilai harus berupa kode ISO 3166 2 huruf yang valid.
policy

Policy

Kebijakan pengembalian.
restocking_fee

RestockingFee

Biaya penyetokan ulang yang berlaku untuk semua kategori alasan pengembalian. Biaya ini akan diperlakukan sebagai biaya penyetokan ulang gratis jika nilainya tidak ditetapkan.
return_methods[]

ReturnMethod

Metode pengembalian terkait cara pelanggan dapat mengembalikan item. Nilai ini wajib diisi kecuali jika jenis kebijakan pengembaliannya 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. Harus ditetapkan hanya jika pelanggan perlu mendownload dan mencetak label pengembalian.
return_policy_uri

string

URI kebijakan pengembalian. Ini dapat digunakan oleh Google untuk melakukan pemeriksaan kesehatan terhadap kebijakan. URL tersebut 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 untuk bertukar produk. Kolom ini wajib diisi.

ItemCondition

Kondisi item yang tersedia.

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

Kebijakan

Kebijakan yang tersedia.

Kolom
type

Type

Jenis kebijakan.
days

int64

Jumlah hari item dapat dikembalikan setelah barang diterima, dengan satu hari ditentukan sebagai 24 jam setelah stempel waktu pengiriman. Wajib untuk pengembalian 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 validnya pengembalian setelah barang diterima.
NO_RETURNS Tidak ada pengembalian barang.
LIFETIME_RETURNS Kembali ke masa hidup.

RestockingFee

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

Kolom

Kolom union type.

type hanya dapat berupa salah satu dari yang berikut:
fixed_fee

Price

Biaya penyetokan ulang tetap.
micro_percent

int32

Persentase total harga dalam mikro. 15.000.000 artinya 15% dari harga total akan dikenakan

ReturnMethod

Metode pengembalian yang tersedia.

Enum
RETURN_METHOD_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BY_MAIL Kembalikan melalui pos.
IN_STORE Pengembalian ke toko.
AT_A_KIOSK Kembali ke kios.

ReturnShippingFee

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

Kolom
type

Type

Jenis biaya pengiriman pengembalian.
fixed_fee

Price

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

Jenis

Jenis biaya pengiriman pengembalian.

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

PhoneVerificationState

Status verifikasi telepon.

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
PHONE_VERIFICATION_STATE_VERIFIED Ponsel 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 umumnya 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 tersebut.
state

State

Hanya output. Status partisipasi akun dalam program.
active_region_codes[]

string

Hanya output. Wilayah tempat akun berpartisipasi secara aktif dalam program. Wilayah aktif didefinisikan sebagai wilayah yang telah memenuhi semua persyaratan program yang memengaruhi wilayah tersebut.

Kode wilayah ditentukan oleh CLDR. Ini dapat berupa negara tempat program berlaku secara khusus untuk negara tersebut atau 001 saat program berlaku secara global.
unmet_requirements[]

Requirement

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

Persyaratan

Mendefinisikan persyaratan yang ditentukan untuk berpartisipasi dalam program.

Kolom
title

string

Hanya output. Nama persyaratan.
documentation_uri

string

Hanya output. URL halaman bantuan yang menjelaskan persyaratannya.
affected_region_codes[]

string

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

Kode wilayah ditentukan oleh CLDR. Ini dapat berupa negara tempat program berlaku secara khusus untuk negara tersebut atau 001 saat program berlaku secara global.

Negara Bagian

Status partisipasi program yang mungkin untuk akun.

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

RateGroup

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

Kolom
applicable_shipping_labels[]

string

Wajib. Daftar label paket yang menentukan untuk produk apa kelompok tarif ini diterapkan. Ini adalah disjungsi: hanya satu label yang harus cocok agar grup tarif dapat diterapkan. Mungkin hanya kosong untuk grup tarif terakhir layanan.
subtables[]

Table

Opsional. Daftar subtabel yang dirujuk oleh main_table. Hanya dapat disetel jika main_table disetel.
carrier_rates[]

CarrierRate

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

Value

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

Table

Tabel yang menentukan grup tarif, saat 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

Mewakili 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 target geografis yang telah ditentukan sebelumnya. Untuk informasi selengkapnya, lihat artikel Menyiapkan wilayah untuk informasi selengkapnya.

Kolom
name

string

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

PostalCodeArea

Opsional. Daftar kode pos yang menentukan area wilayah.
geotarget_area

GeoTargetArea

Opsional. Daftar target geografis yang menentukan area region.
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 target geografis yang menentukan area region.

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 ditetapkan menggunakan kode pos dapat diakses melalui referensi 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 bentuk awalan* yang menunjukkan batas bawah inklusif dari rentang yang menentukan area. Contoh nilai: 94108, 9410*, 9*.
end

string

Opsional. Kode pos atau pola dalam bentuk prefix* yang menunjukkan batas atas inklusif untuk 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, postalCodeRangeEnd harus berupa pola dengan panjang imbuhan yang sama. Opsional: jika tidak ditetapkan, area akan didefinisikan sebagai semua kode pos yang cocok dengan postalCodeRangeBegin.

Wajib

Menjelaskan persyaratan layanan yang harus disetujui.

Kolom
terms_of_service

string

termsOfService yang harus diterima.
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 menerima Format PersyaratanOfServiceAgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Pesan permintaan untuk metode RetrieveLatestTermsOfService.

Kolom
region_code

string

Kode wilayah seperti yang ditetapkan oleh CLDR. Ini bisa berupa negara ketika ToS berlaku secara khusus untuk negara tersebut atau 001 jika berlaku secara global.
kind

TermsOfServiceKind

Jenis versi persyaratan layanan ini diterapkan.

Baris

Menyertakan daftar sel.

Kolom
cells[]

Value

Wajib. Daftar sel yang menyusun 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 memiliki applicable_shipping_labels kosong, yang berarti "lainnya". 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 menampilkan status aktif layanan pengiriman.
currency_code

string

Kode CLDR mata uang yang menggunakan layanan ini. Harus sama dengan harga di kelompok 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.
minimum_order_value

Price

Nilai pesanan minimum untuk layanan ini. Jika ditetapkan, menunjukkan bahwa pelanggan harus membelanjakan setidaknya 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 pemenuhan pesanan pengambilan. Tidak dapat ditetapkan bersama dengan minimum_order_value.
store_config

StoreConfig

Daftar toko asal pengiriman produk Anda. Ini hanya berlaku untuk jenis pengiriman lokal.

LoyaltyProgram

Program loyalitas yang disediakan oleh penjual.

Kolom
loyalty_program_tiers[]

LoyaltyProgramTiers

Opsional. Tingkat program loyalitas dari 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

Bagian dari 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 memerinci jenis pengiriman.
DELIVERY Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan.
LOCAL_DELIVERY Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan. Pesanan dikirimkan dari toko lokal terdekat.
COLLECTION_POINT Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan. Pesanan akan dikirim dari lokasi pengambilan.

StoreConfig

Daftar toko asal pengiriman produk Anda. Ini hanya berlaku untuk jenis pengiriman 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 yang dipilih, yang dicantumkan oleh penjual ini menyediakan pengiriman lokal.
cutoff_config

CutoffConfig

Konfigurasi terkait pengiriman lokal berakhir pada hari itu.
service_radius

Distance

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

CutoffConfig

Konfigurasi terkait pengiriman lokal berakhir pada hari itu.

Kolom
local_cutoff_time

LocalCutoffTime

Waktu pengiriman lokal berakhir pada hari tersebut.
store_close_offset_hours

int64

Hanya berlaku untuk pemenuhan pesanan pengiriman lokal. Menyatakan batas waktu 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 layanan pengiriman mereka dikonfigurasi untuk pengiriman lokal dalam n hari. Misalnya, jika layanan pengiriman menentukan pengiriman di hari yang sama, dan sudah melewati batas waktu, menetapkan kolom ini ke true akan membuat tarif layanan pengiriman yang dihitung akan menampilkan NO_DELIVERY_POST_CUTOFF. Dalam contoh yang sama, menetapkan kolom ini ke false akan menghasilkan waktu pengiriman yang dihitung menjadi satu hari. Ini hanya untuk pengiriman lokal.

LocalCutoffTime

Waktu pengiriman lokal berakhir pada hari tersebut.

Kolom
hour

int64

Jam pengiriman lokal untuk pesanan agar dapat diproses pada hari yang sama.
minute

int64

Pesanan pengiriman lokal menit harus dilakukan untuk memproses hari yang sama.

StoreServiceType

Menunjukkan apakah semua toko, atau toko yang dipilih, yang dicantumkan oleh penjual menyediakan pengiriman lokal.

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Tidak menentukan jenis layanan toko.
ALL_STORES Menunjukkan apakah semua toko, saat ini dan di masa mendatang, yang dicantumkan 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]((https://support.google.com/merchants/answer/6069284) 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 get call dan insert call. 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 penyisipan 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, saat single_value tidak cukup ekspresif.

Kolom
rows[]

Row

Wajib. Daftar baris yang menyusun tabel. Harus memiliki panjang yang sama 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.

TaxRule

Jenis konvensi utama

persen mikro : 100% = 1 000 000 dan 1% = 10 000 tidak boleh negatif.

Informasi tentang nexus pajak dan parameter terkait yang berlaku untuk pesanan yang dikirim ke area yang dicakup oleh satu admin pajak. Nexus tercipta ketika pedagang melakukan bisnis di wilayah yang dikelola oleh admin pajak (hanya negara bagian AS yang didukung untuk konfigurasi nexus). Jika penjual memiliki nexus di negara bagian AS, penjual harus membayar pajak ke semua otoritas pajak yang terkait dengan tujuan pengiriman. ID Berikutnya : 8

Kolom
region_code

string

Kode wilayah tempat aturan ini berlaku
shipping_taxed

bool

Jika ditetapkan, biaya pengiriman akan dikenai pajak (dengan tarif yang sama seperti produk) saat mengirim ke area admin ini. Hanya dapat ditetapkan di negara bagian AS tanpa kategori.
effective_time_period

Interval

Wajib. Jangka waktu saat aturan ini berlaku. Jika durasi tidak ada di effective_time yang tercantum, berarti durasi tersebut terbuka di masa mendatang. Awal jangka waktu ini bersifat inklusif, dan bagian akhirnya bersifat eksklusif.
Kolom union location. Jelaskan lokasi melalui rentang kode pos atau ID kriteria. location hanya ada berupa salah satu diantara berikut:
location_id

int64

Admin_id atau criteria_id wilayah tempat aturan ini diterapkan.
post_code_range

TaxPostalCodeRange

Rentang kode pos tempat aturan ini berlaku.
Kolom union rate_calculation. Bagaimana cara menghitung tarif pajak untuk pengiriman ke area admin ini. Hanya dapat ditetapkan di negara bagian AS. rate_calculation hanya ada berupa salah satu diantara berikut:
use_google_rate

bool

Tarif yang bergantung pada lokasi pengiriman: jika penjual memiliki cabang di negara bagian AS yang terkait, tarif dari otoritas dengan wilayah hukum terkait area pengiriman akan ditambahkan.
self_specified_rate_micros

int64

Tarif tetap yang ditentukan dalam mikro, di mana 100% = 1_000_000. Cocok untuk negara bagian berdasarkan origin.

TaxPostalCodeRange

Rentang kode pos yang menentukan area tersebut.

Kolom
start

string

Wajib. Awal rentang kode pos, yang juga merupakan yang terkecil dalam rentang.
end

string

Akhir rentang kode pos. Akan sama dengan start jika tidak ditentukan.

TermsOfService

TermsOfService.

Kolom
name

string

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

string

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

TermsOfServiceKind

Jenis versi persyaratan layanan ini diterapkan.
external

bool

Apakah versi persyaratan layanan ini bersifat eksternal. Versi persyaratan layanan eksternal hanya dapat disetujui melalui proses eksternal dan tidak secara 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 dan jenis persyaratan layanan tertentu. Statusnya adalah sebagai berikut:

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

Perhatikan bahwa wajib dan diterima dapat ada. Dalam hal ini, tanggal habis masa berlaku persyaratan layanan accepted akan 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 tertentu (URL ke file yang berisi teks ditambahkan dalam pesan Wajib di bawah sebagai tos_file_uri. Penerimaan persyaratan layanan sebenarnya dilakukan dengan memanggil setuju pada resource TermsOfService.

Kolom
name

string

ID. Nama resource versi persyaratan layanan. Format: accounts/{account}/termsOfServiceAgreementState/{identifier}
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 diterima semacam ini dan untuk region_code terkait
required

Required

Persyaratan layanan yang diperlukan

TermsOfServiceKind

Jenis PersyaratanLayanan.

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 untuk 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 wilayah 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, masing-masing ada beberapa baris dengan satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postal_code_group_names, dan kolom (nilai) dengan transit_time_labels.

TransitTimeRow

Jika hanya ada satu kumpulan dimensi postal_code_group_names atau transit_time_labels, masing-masing ada beberapa baris dengan satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postal_code_group_names, dan kolom (nilai) 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 di hari yang sama, 1 berarti pengiriman di 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

Wajib. Daftar kolom yang sedang diperbarui.

UpdateAccountTaxRequest

Permintaan untuk memperbarui setelan pajak

Kolom
account_tax

AccountTax

Wajib. Setelan pajak yang akan diperbarui
update_mask

FieldMask

Daftar kolom yang akan diperbarui

UpdateBusinessIdentityRequest

Pesan permintaan untuk metode UpdateBusinessIdentity.

Kolom
business_identity

BusinessIdentity

Wajib. Versi baru identitas bisnis.
update_mask

FieldMask

Wajib. Daftar kolom yang sedang diperbarui.

UpdateBusinessInfoRequest

Pesan permintaan untuk metode UpdateBusinessInfo.

Kolom
business_info

BusinessInfo

Wajib. Versi baru info bisnis.
update_mask

FieldMask

Wajib. Daftar kolom yang sedang diperbarui.

UpdateEmailPreferencesRequest

Pesan permintaan untuk metode UpdateEmailPreferences.

Kolom
email_preferences

EmailPreferences

Wajib. Preferensi Email yang akan diperbarui.
update_mask

FieldMask

Wajib. Daftar kolom yang sedang diperbarui.

UpdateHomepageRequest

Pesan permintaan untuk metode UpdateHomepage.

Kolom
homepage

Homepage

Wajib. Versi baru halaman beranda.
update_mask

FieldMask

Wajib. Daftar kolom yang sedang diperbarui.

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.

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

FieldMask

Wajib. Daftar kolom yang sedang diperbarui.

Pengguna

Pengguna.

Kolom
name

string

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

State

Hanya output. Status pengguna.
access_rights[]

AccessRight

Opsional. Hak akses yang dimiliki pengguna.

Negara Bagian

Kemungkinan status pengguna.

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

Nilai

Nilai tunggal grup tarif atau nilai sel tabel grup tarif. Tepat satu dari no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name harus ditetapkan.

Kolom
no_shipping

bool

Jika true (benar), produk tidak dapat dikirim. Harus bernilai benar jika ditetapkan, hanya dapat ditetapkan jika semua kolom lain tidak ditetapkan.
flat_rate

Price

Tarif tetap. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan.
price_percentage

string

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

string

Nama tarif ekspedisi yang mengacu pada tarif ekspedisi yang ditentukan dalam grup tarif yang sama. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan.
subtable

string

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

Gudang

Gudang pengadaan, yang menyimpan dan menangani inventaris. Tag berikutnya: 7

Kolom
name

string

Wajib. Nama gudang. Harus unik dalam akun.
shipping_address

Address

Wajib. Alamat pengiriman gudang.
cutoff_time

WarehouseCutoffTime

Wajib. Waktu paling lambat saat pesanan dapat diterima dan mulai diproses. Pesanan akan diproses pada hari berikutnya. Waktu didasarkan pada kode pos gudang.
handling_days

int64

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

BusinessDayConfig

Hari kerja gudang. Jika tidak disetel, akan disetel ke Senin sampai Jumat secara default.

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 harus ditetapkan.

Kolom
carrier

string

Wajib. Operator, seperti "UPS" atau "Fedex".
carrier_service

string

Wajib. Layanan ekspedisi, 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 paling lambat saat pesanan dapat diterima dan mulai diproses. Pesanan akan diproses pada hari berikutnya. Waktu didasarkan pada kode pos gudang.

Kolom
hour

int32

Wajib. Jam dari batas waktu pesanan harus diproses pada hari yang sama oleh gudang. Jam didasarkan pada zona waktu gudang.
minute

int32

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