REST Resource: inventory.partners.merchants

{
  "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)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

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

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.

string

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

string

URL situs publik penjual.

object (GeoCoordinates)

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

string

Kategori bisnis di platform agregator.

string (int64 format)

Kolom ini tidak digunakan lagi.

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.

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.

object (PaymentRestrictions)

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

object (PaymentOption)

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

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

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.

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.

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)

object (ServiceAttribute)

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

object (ActionLink)

Opsional. URL tindakan dengan bahasa terkait, daftar negara yang dibatasi, jenis, dan platform opsional yang menunjukkan pada platform mana tindakan tersebut harus dilakukan,

object (Advisement)

Opsional. Pemberitahuan umum dari penjual tertentu untuk pengguna yang bergabung ke daftar tunggu melalui Reservasi dengan Google. Setiap kolom teks dalam pemberitahuan harus dibatasi hingga 100 byte.

object (EconomicOperator)

Opsional. Informasi Operator Ekonomi yang terkait dengan penjual tertentu ini diperlukan untuk kepatuhan terhadap peraturan. (opsional)

{
  "creditCardRestrictions": {
    object (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.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

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

{
  "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)
  }
}

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.

string

Nama opsi pembayaran. Ini dapat dilihat pengguna.

string

Deskripsi opsi pembayaran. Ini dapat dilihat pengguna.

object (Price)

Harga opsi pembayaran.

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.

enum (PaymentOptionType)

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

string (int64 format)

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

object (TimeRange)

Opsi pembayaran dapat dibeli dalam interval ini.

object (TimeRange)

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

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".

enum (ActivationType)

Menentukan cara tanggal mulai validitas ditentukan untuk opsi pembayaran ini.

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.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

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

boolean

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

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

enum (Processor)

Menentukan partner pemroses pembayaran yang menerapkan konfigurasi ini.

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

string

Nomor versi API dikirim ke pemroses pembayaran beserta permintaan pembayaran.

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

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" }.

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.

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

string

Secara opsional, URL untuk Persyaratan dan Ketentuan.

string

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

object (Text)

Teks yang dilokalkan untuk ditampilkan kepada pengguna.

{
  "placeId": string
}

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.

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

string

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

string

Nama yang dilihat pengguna untuk atribut ini, misalnya "Jenis Akun".

object (Value)

Semua nilai yang mungkin untuk atribut layanan ini.

{
  "valueId": string,
  "valueName": string
}

string

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

string

Nama yang dilihat pengguna untuk nilai, mis., "Pribadi".

{
  "text": {
    object (Text)
  }
}

object (Text)

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

{
  "text": {
    object (Text)
  }
}

object (Text)

Wajib. Nama, alamat, nomor telepon, dan alamat email operator ekonomi, yang didefinisikan sebagai produsen, perwakilan resmi, importir, distributor, penyedia layanan fulfillment, atau orang fisik atau hukum lainnya yang tunduk pada kewajiban terkait pembuatan produk, menyediakannya, atau mengoperasikannya. Representasi string freeform dari economicOperator. Informasi ini dapat diformat menggunakan " " dan "\n".