REST Resource: inventory.partners.merchants

Kaynak: Satıcı

Toplayıcının platformundaki bir satıcı hakkında bilgiler.

JSON gösterimi 
{
  "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)
    }
  ],
  "reservationLinkoutTemplate": [
    {
      object (LinkoutTemplate)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
Alanlar
name

string

partners/{partner_id}/merchants/{merchantId} biçimindeki satıcı kaynak adı.
merchantName

string

merchantName, telephone, url ve geo, iş ortağı envanterinin Google Haritalar'da zaten mevcut olan satıcılarla eşleştirilmesini desteklemek için kullanılır. Bu bilgiler gösterilmez.

Satıcının adı.
telephone

string

Ülke ve alan kodları dahil olmak üzere satıcının herkese açık telefon numarası (ör. +14567891234).
url

string

Satıcının herkese açık web sitesinin URL'si.
geo

object (GeoCoordinates)

Enlem, boylam ve adres dahil olmak üzere satıcının coğrafi bilgileri.
category

string

Toplayıcının platformundaki işletmenin kategorisi.
numBookings30d
(deprecated)

string (int64 format)

Bu alan kullanımdan kaldırılmıştır.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

Satıcının vergi oranı, baz puan cinsinden (yüzde birin yüzde biri). Örneğin, vergi oranı %7,5 ise bu alan 750 olarak ayarlanmalıdır.

Bu alan ayarlanmazsa veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, Service.price tarafından belirtilen fiyatın aynısıdır. Hizmet fiyatının, geçerli vergilerden muaf olduğu veya bu vergileri zaten içerdiği varsayılır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfırdan farklı bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan alınan toplam fiyata hizmet fiyatı ve burada sağlanan vergi oranı kullanılarak değerlendirilen vergi dahil edilir. En küçük para biriminin kesirleri (örneğin, bir sentin kesirleri) en yakın çift sayıya yuvarlama yöntemiyle yuvarlanır. Vergiler, kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alanın desteği sonlandırılmıştır. Lütfen bunun yerine taxRate alanını kullanın.
taxRate
(deprecated)

object (TaxRate)

Satıcının vergi oranı. Bu alan varsa kullanımdan kaldırılan taxRateBasisPoints alanını geçersiz kılar. Boş bir mesaj (ör. taxRate { }) uygulanan vergi oranını sıfırlar. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.
paymentRestrictions
(deprecated)

object (PaymentRestrictions)

Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar. Bu alan ayarlanmamışsa herhangi bir kısıtlamanın olmadığını varsayarız. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.
paymentOption[]
(deprecated)

object (PaymentOption)

Bu satıcı için kullanılabilen ödeme seçenekleri. Bu satıcıya bağlı hizmetler, izin verdikleri ödeme seçeneklerini ayrı ayrı sınırlayabilir. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma.
tokenizationConfig
(deprecated)

object (TokenizationConfig)

Satıcının desteklemesi durumunda, jetonlu ödeme işleyici için yapılandırma. E2E ödemeleri artık desteklenmediğinden kullanımdan kaldırıldı.
terms

object (Terms)

Google ile Rezervasyon üzerinden hizmet rezervasyonu yapılırken kullanıcıya gösterilen ilgili satıcının Hüküm ve Koşulları. Bunlara ek olarak, toplayıcı iş ortağının Hüküm ve Koşulları her zaman kullanıcıya gösterilir ve burada sağlanmamalıdır.
brandId

string

İş ortağı ilişkilendirmesi gösterilirken kullanılacak tüketiciye yönelik markayı tanımlayan opak bir dize. Bu alan, tüketicilere yönelik birden fazla markası olan iş ortaklarının aynı feed'de tüm markalar için satıcı sağlamasına olanak tanır.

Marka; ad, logo, Hizmet Şartları ve Gizlilik Politikası gibi tüketicilere yönelik özelliklerden oluşur.

Tüketicilere yönelik tek bir iş ortağı markası varsa bu alanın ayarlanması gerekmez ve yoksayılabilir.

İş ortağı...

Tüketicilere yönelik birden fazla markası olmamalıdır. --> Bu alanı yoksay

Yapılandırılmış birden fazla markası var mı?

  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

Önemli Not: Çoğu iş ortağının bu alanı ayarlaması gerekmez. Bir iş ortağı bu alanı kullanmak istiyorsa önce bizimle iletişime geçerek varsayılan marka da dahil olmak üzere ayrı markaları yapılandırmalıdır.
matchingHints

object (MerchantMatchingHints)

Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olacak ipuçları. Not: Google, yukarıda verilen bilgileri kullanarak satıcıları Google Haritalar'daki yerlerle eşleştireceğinden çoğu iş ortağının bu alanı ayarlaması gerekmez. (isteğe bağlı)
serviceAttribute[]

object (ServiceAttribute)

Bu Satıcı için Hizmetleri açıklamak üzere kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı)
reservationLinkoutTemplate[]

object (LinkoutTemplate)

İsteğe bağlı. Google'ın, iş ortağının platformunda masa ayırtmak için URL'yi nasıl oluşturması gerektiğini belirten yönlendirme bağlantısı şablonu.

Birden fazla değer sağlanırsa şu anda yalnızca ilk değerin kullanılacağını unutmayın.

URI şablonu, kullanıcının rezervasyon seçimlerine göre doldurulacak alanları destekler. Rezervasyon URL'sinin başarılı bir şekilde oluşturulması için tüm zorunlu alanlar gereklidir: * (zorunlu) partySize, int: Kullanıcının rezervasyon isteğinde bulunduğu grup boyutu. * (zorunlu) selected_date_time, ISO 8601 datetime (https://en.wikipedia.org/wiki/ISO_8601): Kullanıcının rezervasyon istediği saat. * (isteğe bağlı) merchantId, dize: Kullanıcının rezervasyon isteğinde bulunduğu satıcının kimliği. Şablon zaten bir satıcı tanımlayıcı içeriyorsa gerekli değildir. * (isteğe bağlı) roomId, dize: Kullanıcının rezervasyon isteğinde bulunduğu odanın kimliği.
waitlistAdvisement

object (Advisement)

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan bir kullanıcı için belirli bir satıcının genel tavsiyeleri. Tavsiye metnindeki her bir alan 100 bayt uzunluğunda olmalıdır.
economicOperator

object (EconomicOperator)

İsteğe bağlı. Yasalara uygunluk için bu satıcıyla ilişkili ekonomik operatör bilgilerinin sağlanması gerekir. (isteğe bağlı)

PaymentRestrictions

Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar.

JSON gösterimi 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
Alanlar
creditCardRestrictions

object (CreditCardRestrictions)

Bu satıcının kabul ettiği kredi kartlarıyla ilgili kısıtlamalar. Bu alan ayarlanmamışsa tüm kredi kartlarının kabul edildiği varsayılır. CreditCardType tarafından desteklenen kartların listesinin zaman içinde genişleyeceğini unutmayın. Bu nedenle, bu alanı boş bırakmak yapılandırmayı gelecekteki değişikliklere tabi kılar.

CreditCardRestrictions

Bu satıcının kabul ettiği kredi kartı türleriyle ilgili kısıtlamalar.

JSON gösterimi 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
Alanlar
creditCardType[]

enum (CreditCardType)

Desteklenen kredi kartlarının listesi. Boşsa kredi kartları desteklenmez.

CreditCardType

Kredi kartı türü.

Sıralamalar
CREDIT_CARD_TYPE_UNSPECIFIED Kullanılmamış.
VISA Visa kredi kartı
MASTERCARD Mastercard kredi kartı
AMERICAN_EXPRESS American Express kredi kartı
DISCOVER Bir Discover kredi kartı.
JCB JCB kredi kartı

PaymentOption

Bir satıcı tarafından sağlanan hizmetlerin ödemesini yapmak için kullanılabilecek bir ödeme seçeneği. Ödeme seçenekleri birden fazla satıcı arasında (ör. aynı zincire ait satıcılar) paylaşılabilir.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
paymentOptionId

string

Bu kimlik, ödeme seçeneğini tanımlamak için kullanılır.

Bu kimlik, toplayıcının tamamı için geçerlidir ve birden fazla satıcıda aynı değerin yeniden kullanılması, kullanıcının bu satıcılarda ilgili ödeme seçeneğiyle ödeme yapmasına olanak tanır.

Bir kimlik birden fazla satıcıda yeniden kullanıldığında, bir satıcı altındaki ödeme seçeneği için herhangi bir değerin güncellenmesi, farklı bir satıcı altındaki aynı kimliğe sahip diğer ödeme seçeneklerini de günceller. Bu nedenle, tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlere güncellenmesi, olası bir eksiklik davranışını önlemek için en iyi uygulamadır.
name

string

Ödeme seçeneğinin adı. Bu durum kullanıcı tarafından görülebilir.
description

string

Ödeme seçeneğinin açıklaması. Bu durum kullanıcı tarafından görülebilir.
price

object (Price)

Ödeme seçeneğinin fiyatı.
taxRate

object (TaxRate)

Bu ödeme seçeneğinin vergi oranı. Bu alan varsa satıcıda veya hizmette bulunan taxRate alanını geçersiz kılar. Boş bir mesaj (ör. taxRate { }) uygulanan vergi oranını sıfırlar.
paymentOptionType

enum (PaymentOptionType)

Bu ödeme seçeneğinin türü. Drop-in'ler için tek kullanımlık, paketler için çok kullanımlık, üyelikler için sınırsızdır.
sessionCount

string (int64 format)

Bu ödeme seçeneğinin kaç oturum için kullanılabileceği. Yalnızca değerin > 1 olması gereken çok oturumlu / paketler için geçerlidir.
purchaseInterval

object (TimeRange)

Ödeme seçeneği bu aralıkta satın alınabilir.
validInterval

object (TimeRange)

Ödeme seçeneği bu aralıkta kullanılabilir (ör. Ocak 2017 için özel fiyat). Mevcut olduğunda bu, validDuration ve activationType'ı geçersiz kılar.
validDuration

string (Duration format)

Ödeme seçeneğinin geçerlilik süresi (ör. 30 günlük üyelik).

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
activationType

enum (ActivationType)

Bu ödeme seçeneği için geçerlilik başlangıç tarihinin nasıl belirleneceğini tanımlar.
userRestriction

object (UserPurchaseRestriction)

Bu ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar. Promosyon ödeme seçeneğini bir kullanıcı alt kümesiyle sınırlamak için kullanılabilir. Ayarlanmazsa tüm kullanıcılar uygundur.

PaymentOptionType

Ödeme seçeneği türü.

Sıralamalar
PAYMENT_OPTION_TYPE_UNSPECIFIED Kullanılmamış.
PAYMENT_OPTION_SINGLE_USE Ödeme seçeneği yalnızca bir kez kullanılabilir.
PAYMENT_OPTION_MULTI_USE Oturum sayısı > 0 ise ödeme seçeneği kullanılabilir.
PAYMENT_OPTION_UNLIMITED Ödeme seçeneği, geçerli olduğu süre aralığında kullanılabilir. Oturum sayısı geçerli değildir.

ActivationType

Geçerlilik başlangıç tarihinin nasıl belirleneceğini tanımlar.

Sıralamalar
ACTIVATION_TYPE_UNSPECIFIED Kullanılmamış.
ACTIVATION_ON_PURCHASE Geçerlilik süresi, satın alma işlemi sırasında başlar.
ACTIVATION_ON_FIRST_USE Geçerlilik, ödeme seçeneği ilk kez kullanıldığında başlar.

UserPurchaseRestriction

Ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar.

JSON gösterimi 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
Alanlar
newToMerchant

boolean

Yalnızca daha önce aynı satıcıdan satın alma işlemi yapmamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneği.
newToPaymentOption

boolean

Daha önce aynı ödeme seçeneğini satın almamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneği.

PaymentProcessorConfig

Ödeme işleyici yapılandırması, satıcı bazında ayarlanır.

JSON gösterimi 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
Alanlar
processor

enum (Processor)

Bu yapılandırmanın geçerli olduğu ödeme işleme iş ortağını tanımlar.
publicKey

string

Bu satıcıyı ödeme işleyicisiyle tanımlamak için kullanılan anahtar.

Stripe için: https://stripe.com/docs/dashboard#api-keys Braintree için: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

Ödeme istekleriyle birlikte ödeme işleyiciye gönderilen API sürüm numarası.

İşlemci

Belirli bir ödeme işleme iş ortağını tanımlar.

Sıralamalar
PROCESSOR_UNSPECIFIED Kullanılmamış
PROCESSOR_STRIPE Stripe ile ödemeler için yapılandırma.
PROCESSOR_BRAINTREE Braintree ile ödemeler için yapılandırma.

TokenizationConfig

Ödeme işleyici jetonlaştırması için satıcı bazında ayarlanan bir yapılandırma.

JSON gösterimi 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
Alanlar
tokenizationParameter

map (key: string, value: string)

Bir jetonlaştırma yapılandırmasında genellikle anahtarı "gateway" olan ve değeri işlemcinin adı olan bir tokenizationParameter bulunur.

Diğer parametreler işlemciye bağlıdır. Daha fazla bilgi için Google Pay'in belgelerini inceleyin.

Braintree örneği: 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" }

Stripe örneği: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Adyen örneği: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
billingInformationFormat

enum (BillingInformationFormat)

Ödeme tokenına, kullanıcının Google Pay'e FOP'siyle (yukarıya bakın) girdiği fatura bilgilerini ekleyin. Alanı boş bırakmak, MIN değerini belirtmekle aynıdır.

BillingInformationFormat

Kullanıcıdan ne kadar fatura adresi bilgisi isteneceğini ve jetona ne kadarının dahil edileceğini belirler. Numaralandırılmış değerler, Google Pay API'deki parametrelere karşılık gelir (bkz. https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).

Sıralamalar
BILLING_INFORMATION_FORMAT_UNSPECIFIED Belirtilmedi. Varsayılan olarak MIN değerine ayarlanır.
MIN ad, ülke kodu ve posta kodu (Google Pay varsayılan ayarı).
FULL ad, açık adres, yerleşim yeri, bölge, ülke kodu ve posta kodu.

Şartlar

Google ile Rezervasyon üzerinden rezervasyon yapmak için kullanıcıya gösterilen bir dizi kural ve yönerge.

JSON gösterimi 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
Alanlar
url

string

İsteğe bağlı olarak, Hükümler ve Koşullar'ın URL'si.
text

string

Kullanıcıya gösterilecek metin. Yeni entegrasyonlar için aşağıdaki localizedText'i kullanın.
localizedText

object (Text)

Kullanıcıya gösterilecek yerelleştirilmiş metin.

MerchantMatchingHints

Google'ın bir satıcıyı Google Haritalar'daki bir yerle eşleştirmesine yardımcı olmak için kullanılan ipuçları.

JSON gösterimi 
{
  "placeId": string
}
Alanlar
placeId

string

Google Places veritabanında ve Google Haritalar'da bir yerin yer kimliği. Yer kimlikleri hakkında daha fazla bilgi için https://developers.google.com/places/web-service/place-id adresini ziyaret edin.

ServiceAttribute

Hizmet özellikleri, bir satıcının hizmetlerini tanımlayan, iş ortağı tarafından tanımlanmış kategorilerdir. Örneğin, bir banka olası değerleri "Kişisel" ve "İşletme" olan bir "Hesap Türü" hizmet özelliği tanımlayabilir. Bir kuaför ise olası değerleri "Saç Kesimi", "Boyama" ve "Şekillendirme" olan bir "Hizmet Türü" hizmet özelliği tanımlayabilir.

JSON gösterimi 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
Alanlar
attributeId

string

Bu hizmet özelliğini aynı satıcının diğer hizmet özellikleri arasında benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "account-type").
attributeName

string

Bu özelliğin kullanıcı tarafından görülebilen adı (ör. "Hesap Türü").
value[]

object (Value)

Bu hizmet özelliği için olası tüm değerler.

Değer

Belirli bir hizmet özelliği için olası bir değeri temsil eder.

JSON gösterimi 
{
  "valueId": string,
  "valueName": string
}
Alanlar
valueId

string

Bu hizmet özelliği için bu değeri diğerleri arasında benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "kişisel").
valueName

string

Değer için kullanıcı tarafından görülebilen bir ad (ör. "Kişisel").

LinkoutTemplate

Google'ın bir iş ortağının sitesine yönelik URL'leri nasıl oluşturacağını belirten bir şablon.

JSON gösterimi 
{
  "uriTemplate": string
}
Alanlar
uriTemplate

string

URI şablonu RFC 6570'e uygun olmalıdır. https://datatracker.ietf.org/doc/html/rfc6570 adresine bakın. 1. düzey şablonları ve tüm 4.düzey birleşik şablonları destekler. Örneğin: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

Tavsiye

Google ile Rezervasyon üzerinden rezervasyon yaparken kullanıcıya gösterilen tavsiyeler.

JSON gösterimi 
{
  "text": {
    object (Text)
  }
}
Alanlar
text

object (Text)

Google ile Rezervasyon üzerinden rezervasyon yaparken kullanıcıya gösterilecek özel mesaj.

EconomicOperator

Toplayıcı için ekonomik operatör bilgileri.

JSON gösterimi 
{
  "text": {
    object (Text)
  }
}
Alanlar
text

object (Text)

Zorunlu. Üretici, yetkili temsilci, ithalatçı, distribütör, sipariş karşılama hizmeti sağlayıcı veya ürünlerin üretimi, kullanıma sunulması ya da hizmete alınmasıyla ilgili yükümlülüklere tabi olan diğer gerçek veya tüzel kişiler olarak tanımlanan ekonomik operatörün adı, adresi, telefon numarası ve e-posta adresi. economicOperator'ın serbest biçimli dize gösterimi. Bu bilgiler " " ve "\n" kullanılarak biçimlendirilebilir.

Yöntemler

create

 Belirtilen toplayıcı tarafından yönetilen yeni bir Merchant oluşturur ve döndürür.

delete

 Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant öğesini siler.

getStatus

 Merchant ile MerchantStatus avantajlarından yararlanın.

patch

 Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant öğesini günceller ve döndürür.