REST Resource: inventory.partners.merchants

Resource: Merchant

Info tentang penjual yang ada di platform agregator.

Representasi JSON
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  }
}
Kolom
name

string

Nama resource penjual, yang memiliki format partners/{partner_id}/merchants/{merchantId}.

merchantName

string

MerchantName, telepon, url, dan geo digunakan untuk mendukung kecocokan inventaris partner dengan penjual yang sudah ada di Google Maps. Informasi ini tidak akan ditampilkan.

Nama penjual.

telephone

string

Nomor telepon publik penjual termasuk kode negara dan areanya, mis. +14567891234.

url

string

URL situs publik penjual.

geo

object (GeoCoordinates)

Info Geografis penjual, termasuk lintang, bujur, dan alamat.

category

string

Kategori bisnis di platform agregator.

numBookings30d
(deprecated)

string (int64 format)

Kolom ini tidak digunakan lagi.

taxRateBasisPoints
(deprecated)

integer (uint32 format)

Tarif pajak penjual dalam poin dasar (seribu dari satu persen). Misalnya, jika tarif pajak adalah 7,5%, kolom ini harus ditetapkan ke 750.

Jika kolom ini tidak ditetapkan atau ditetapkan ke 0, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini adalah harga persis yang ditentukan oleh Service.price. Harga layanan diasumsikan bebas dari atau sudah termasuk pajak yang berlaku. Pajak tidak akan ditampilkan kepada pengguna sebagai item baris terpisah.

Jika kolom ini ditetapkan ke nilai selain nol, total harga yang ditagihkan kepada pengguna untuk layanan apa pun yang disediakan oleh penjual ini akan mencakup harga layanan ditambah pajak yang dihitung menggunakan tarif pajak yang diberikan di sini. Pecahan dari satuan mata uang terkecil (misalnya, pecahan dari satu sen) akan dibulatkan menggunakan pembulatan genap terdekat. Pajak akan ditampilkan kepada pengguna sebagai item baris terpisah.

Kolom ini tidak digunakan lagi, sebagai gantinya gunakan taxRate.

taxRate

object (TaxRate)

Tarif pajak penjual. Jika ada, kolom ini akan mengganti kolom taxRateBasisPoints yang tidak digunakan lagi. Pesan kosong (yaitu taxRate { }) akan mereset tarif pajak yang berlaku ke nol.

paymentRestrictions

object (PaymentRestrictions)

Batasan metode pembayaran yang diterima penjual ini. Kami mengasumsikan tidak ada batasan jika kolom ini tidak ditetapkan.

paymentOption[]

object (PaymentOption)

Opsi pembayaran yang tersedia untuk penjual ini. Layanan pada penjual ini akan dapat membatasi opsi pembayaran yang mereka izinkan secara individu.

paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya.

tokenizationConfig

object (TokenizationConfig)

Konfigurasi untuk pemroses pembayaran token, jika penjual memiliki dukungan untuknya.

terms

object (Terms)

Persyaratan dan Ketentuan penjual tertentu yang ditampilkan kepada pengguna saat layanan dipesan melalui Pesan dengan Google. Selain hal tersebut, Persyaratan dan Ketentuan partner agregator selalu ditampilkan kepada pengguna dan tidak boleh disediakan di sini.

brandId

string

String buram yang mengidentifikasi merek yang ditampilkan ke konsumen untuk digunakan saat menampilkan atribusi partner. Kolom ini memungkinkan partner dengan beberapa merek yang ditampilkan ke konsumen memberikan penjual untuk semua merek dalam feed yang sama.

Merek terdiri dari properti yang dilihat konsumen seperti nama, logo, Persyaratan Layanan, dan Kebijakan Privasi.

Jika hanya ada satu merek partner yang ditampilkan ke konsumen, kolom ini tidak perlu ditetapkan dan dapat diabaikan.

Jika partner...

Apakah tidak memiliki beberapa merek yang dilihat pelanggan? --> Abaikan kolom ini

Punya Beberapa Merek yang dikonfigurasi?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Perhatian: sebagian besar partner tidak perlu menetapkan kolom ini. Jika partner ingin menggunakan kolom ini, partner harus menghubungi kami terlebih dahulu untuk mengonfigurasi merek terpisah, termasuk merek default.

matchingHints

object (MerchantMatchingHints)

Petunjuk untuk membantu Google mencocokkan penjual dengan suatu tempat di Google Maps. Catatan: sebagian besar partner tidak perlu menetapkan kolom ini, karena Google akan mencocokkan penjual dengan suatu tempat di Google Maps menggunakan informasi yang diberikan di atas. (opsional)

serviceAttribute[]

object (ServiceAttribute)

Definisi untuk setiap atribut layanan yang digunakan untuk mendeskripsikan Layanan bagi Penjual ini. (opsional)

waitlistAdvisement

object (Advisement)

Opsional. Saran umum dari penjual tertentu untuk pengguna yang bergabung ke daftar tunggu melalui Pesan dengan Google. Panjang kolom teks individual dalam saran harus dibatasi hingga 100 byte.

PaymentRestrictions

Batasan metode pembayaran yang diterima penjual ini.

Representasi JSON
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Kolom
creditCardRestrictions

object (CreditCardRestrictions)

Batasan pada kartu kredit yang diterima penjual ini. Kami berasumsi bahwa semua kartu kredit diterima jika kolom ini tidak ditetapkan. Perhatikan bahwa daftar kartu yang didukung oleh CreditCardType akan bertambah dari waktu ke waktu, artinya jika kolom ini dikosongkan, sebuah konfigurasi dapat berubah di masa mendatang.

CreditCardRestrictions

Batasan pada jenis kartu kredit yang diterima penjual ini.

Representasi JSON
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Kolom
creditCardType[]

enum (CreditCardType)

Daftar kartu kredit yang didukung. Tidak ada kartu kredit yang didukung jika kosong.

CreditCardType

Jenis kartu kredit.

Enum
CREDIT_CARD_TYPE_UNSPECIFIED Tidak digunakan.
VISA Kartu kredit Visa.
MASTERCARD Kartu kredit Mastercard.
AMERICAN_EXPRESS Kartu kredit American Express.
DISCOVER Kartu kredit Discover.
JCB Kartu kredit JCB.

PaymentOption

Opsi pembayaran, yang dapat digunakan untuk membayar layanan yang disediakan penjual. Opsi pembayaran dapat dibagikan di antara beberapa penjual (mis. penjual di jaringan yang sama).

Representasi JSON
{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
Kolom
paymentOptionId

string

ID ini digunakan untuk mengidentifikasi opsi pembayaran ini.

ID ini bersifat global untuk seluruh agregator, dan penggunaan kembali nilai dalam beberapa penjual akan memungkinkan pengguna membayar dengan opsi pembayaran yang sesuai di semua penjual tersebut.

Saat menggunakan kembali ID di beberapa penjual, memperbarui nilai apa pun untuk opsi pembayaran pada satu penjual juga akan memperbarui opsi pembayaran lainnya dengan ID yang sama, pada penjual yang berbeda. Oleh karena itu, sebaiknya semua opsi pembayaran yang memiliki ID sama selalu diperbarui ke nilai yang identik untuk menghindari kemungkinan perilaku yang tidak deterministik.

name

string

Nama opsi pembayaran. Ini dapat dilihat pengguna.

description

string

Deskripsi opsi pembayaran. Ini dapat dilihat pengguna.

price

object (Price)

Harga opsi pembayaran.

taxRate

object (TaxRate)

Tarif pajak untuk opsi pembayaran ini. Jika ada, kolom ini akan mengganti kolom taxRate yang ada di Penjual atau Layanan. Pesan kosong (yaitu taxRate { }) akan mereset tarif pajak yang berlaku ke nol.

paymentOptionType

enum (PaymentOptionType)

Jenis opsi pembayaran ini. Penggunaan tunggal untuk penurunan, multi-penggunaan untuk paket, dan tanpa batas untuk keanggotaan.

sessionCount

string (int64 format)

Jumlah sesi yang dapat digunakan oleh opsi pembayaran ini. Hanya valid untuk multi-sesi/paket, dengan nilai harus > 1.

purchaseInterval

object (TimeRange)

Opsi pembayaran dapat dibeli dalam interval ini.

validInterval

object (TimeRange)

Opsi pembayaran dapat digunakan dalam interval ini (mis., harga khusus untuk Januari 2017). Jika ada, metode ini akan mengganti validDuration dan activationType.

validDuration

string (Duration format)

Durasi validitas opsi pembayaran (mis., keanggotaan 30 hari).

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

activationType

enum (ActivationType)

Menentukan cara tanggal mulai validitas ditentukan untuk opsi pembayaran ini.

userRestriction

object (UserPurchaseRestriction)

Membatasi pengguna yang valid untuk membeli opsi pembayaran ini. Dapat digunakan untuk membatasi opsi pembayaran promosi ke subkumpulan pengguna. Jika tidak ditetapkan, semua pengguna memenuhi syarat.

PaymentOptionType

Jenis opsi pembayaran.

Enum
PAYMENT_OPTION_TYPE_UNSPECIFIED Tidak digunakan.
PAYMENT_OPTION_SINGLE_USE Opsi pembayaran hanya dapat digunakan sekali.
PAYMENT_OPTION_MULTI_USE Opsi pembayaran dapat digunakan jika jumlah sesinya > 0.
PAYMENT_OPTION_UNLIMITED Opsi pembayaran dapat digunakan dalam rentang waktu yang valid - jumlah sesi tidak dapat diterapkan.

ActivationType

Menentukan bagaimana tanggal mulai validitas ditentukan.

Enum
ACTIVATION_TYPE_UNSPECIFIED Tidak digunakan.
ACTIVATION_ON_PURCHASE Validitas dimulai pada saat pembelian.
ACTIVATION_ON_FIRST_USE Validitas dimulai saat opsi pembayaran digunakan untuk pertama kalinya.

UserPurchaseRestriction

Membatasi pengguna yang memenuhi syarat untuk membeli opsi pembayaran.

Representasi JSON
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Kolom
newToMerchant

boolean

Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli dari penjual yang sama sebelumnya.

newToPaymentOption

boolean

Opsi pembayaran yang hanya dapat dibeli oleh pengguna yang belum pernah membeli opsi pembayaran yang sama sebelumnya.

PaymentProcessorConfig

Konfigurasi untuk pemroses pembayaran, yang disiapkan per Penjual.

Representasi JSON
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Kolom
processor

enum (Processor)

Menentukan partner pemroses pembayaran yang menerapkan konfigurasi ini.

publicKey

string

Kunci yang digunakan untuk mengidentifikasi penjual ini dengan pemroses pembayaran.

Untuk Stripe, lihat: https://stripe.com/docs/dashboard#api-keys Untuk Braintree, lihat: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

version

string

Nomor versi API yang dikirim ke pemroses pembayaran beserta permintaan pembayaran.

Processor

Menentukan partner pemroses pembayaran tertentu.

Enum
PROCESSOR_UNSPECIFIED Tidak digunakan
PROCESSOR_STRIPE Konfigurasi untuk pembayaran dengan stripe.
PROCESSOR_BRAINTREE Konfigurasi untuk pembayaran dengan Braintree.

TokenizationConfig

Konfigurasi untuk tokenisasi pemroses pembayaran, yang disiapkan per Penjual.

Representasi JSON
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Kolom
tokenizationParameter

map (key: string, value: string)

Konfigurasi tokenisasi biasanya akan memiliki satu tokenizationParameter yang kuncinya adalah "gateway" dan yang nilainya adalah nama pemroses.

Sisa parameter bergantung pada pemroses. Lihat dokumentasi Google Pay untuk mengetahui informasi lebih lanjut.

Contoh Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Contoh Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Contoh Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

billingInformationFormat

enum (BillingInformationFormat)

Sertakan dalam token pembayaran, informasi penagihan pengguna seperti yang dimasukkan ke Google Pay dengan FOP (lihat di atas). Mengosongkan kolom sama dengan menentukan MIN.

BillingInformationFormat

Seberapa lengkap Alamat Penagihan yang diperlukan dari pengguna dan disertakan dalam token. Nilai enum sesuai dengan parameter di Google Pay API (lihat https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Enum
BILLING_INFORMATION_FORMAT_UNSPECIFIED Tidak dicantumkan. Default-nya adalah MIN.
MIN nama, kode negara, dan kode pos (setelan default Google Pay).
FULL nama, alamat jalan, lokalitas, wilayah, kode negara, dan kode pos.

Terms

Kumpulan aturan dan pedoman yang ditampilkan kepada pengguna untuk membuat pemesanan melalui Pesan dengan Google.

Representasi JSON
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Kolom
url

string

(Opsional) URL ke Persyaratan dan Ketentuan.

text

string

Teks yang akan ditampilkan kepada pengguna. Gunakan localizedText di bawah untuk integrasi baru.

localizedText

object (Text)

Teks yang dilokalkan yang akan ditampilkan kepada pengguna.

MerchantMatchingHints

Petunjuk yang digunakan untuk membantu Google mencocokkan penjual dengan suatu tempat di Google Maps.

Representasi JSON
{
  "placeId": string
}
Kolom
placeId

string

ID Tempat untuk suatu tempat di database Google Places dan di Google Maps. Lihat https://developers.google.com/places/web-service/place-id untuk mengetahui ID Tempat lebih lanjut.

ServiceAttribute

Atribut layanan adalah kategori yang ditentukan partner yang mendeskripsikan Layanan untuk Penjual. Misalnya, bank dapat menentukan atribut layanan "Jenis Rekening" dengan kemungkinan nilai "Pribadi" dan "Bisnis", sementara salon rambut dapat menentukan atribut layanan "Jenis Layanan" dengan kemungkinan nilai "Potong Rambut", "Warna", dan "Gaya".

Representasi JSON
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Kolom
attributeId

string

ID yang mengidentifikasi atribut layanan ini secara unik di antara atribut lainnya untuk penjual yang sama, misalnya, "jenis akun".

attributeName

string

Nama yang terlihat oleh pengguna untuk atribut ini, mis. "Jenis Akun".

value[]

object (Value)

Semua nilai yang mungkin untuk atribut layanan ini.

Value

Merepresentasikan kemungkinan nilai untuk atribut layanan tertentu.

Representasi JSON
{
  "valueId": string,
  "valueName": string
}
Kolom
valueId

string

ID yang mengidentifikasi nilai ini secara unik di antara nilai lainnya untuk atribut layanan ini, misalnya, "pribadi".

valueName

string

Nama yang terlihat oleh pengguna untuk nilai, mis. "Pribadi".

Saran

Saran yang ditampilkan kepada pengguna saat memesan melalui Pesan dengan Google.

Representasi JSON
{
  "text": {
    object (Text)
  }
}
Kolom
text

object (Text)

Pesan kustom yang akan ditampilkan kepada pengguna saat memesan melalui Pesan dengan Google.

Metode

create

Membuat Merchant baru yang dikelola oleh agregator yang ditentukan, dan menampilkannya.

delete

Menghapus Merchant yang ada yang dikelola oleh agregator yang ditentukan.

getStatus

Mendapatkan MerchantStatus dari Merchant.

patch

Memperbarui Merchant yang ada yang dikelola oleh agregator yang ditentukan, dan menampilkannya.