REST Resource: inventory.partners.merchants

Kaynak: Merchant

Toplayıcının platformunda yer alan satıcıyla ilgili 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)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
Alanlar
name

string

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

string

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

Satıcının adı.
telephone

string

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

string

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

object (GeoCoordinates)

Satıcının enlem, boylam ve adres dahil olmak üzere 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 baz puan cinsinden vergi oranı (yüzde birden yüz). Örneğin, vergi oranı %7,5 ise bu alan 750 olarak ayarlanmalıdır.

Bu alan ayarlanmadan bırakılırsa 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 içerdiği varsayılır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfır olmayan bir değere ayarlanırsa bu satıcı tarafından sağlanan herhangi bir hizmet için kullanıcıdan tahsil edilen toplam fiyat, hizmet fiyatının yanı sıra burada sağlanan vergi oranı kullanılarak hesaplanan vergiyi içerir. En küçük para birimi biriminin kesirleri (ör. bir sentin kesirleri) en yakın çift sayıya yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alanın desteği sonlandırıldı. Lütfen bunun yerine taxRate alanını kullanın.
taxRate

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ıra sıfırlar.
paymentRestrictions

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ıtlama olmadığı varsayılır.
paymentOption[]

object (PaymentOption)

Bu satıcı için kullanılabilen ödeme seçenekleri. Bu satıcının altındaki hizmetler, izin verdikleri ödeme seçeneklerini tek tek sınırlayabilir.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

Satıcının desteklediği durumlarda jetonlu ödeme işleyici yapılandırması.
tokenizationConfig

object (TokenizationConfig)

Satıcının desteklemesi varsa token atanmış bir ödeme işleyici için yapılandırma.
terms

object (Terms)

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

string

İş ortağı ilişkilendirmesini gösterirken kullanılacak tüketiciye yönelik markayı tanımlayan opak bir dize. Bu alan, tüketiciye yönelik birden fazla markaya sahip iş ortaklarının aynı feed'deki tüm markalar için satıcılara hizmet vermesini sağlar.

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

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

İş ortağı...

Tüketicilere yönelik birden fazla markası yok mu? --> Bu alanı yoksay

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

  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

Dikkat: Çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. Bir iş ortağı bu alanı kullanmak isterse varsayılan marka dahil olmak üzere ayrı markalar yapılandırmak için önce bizimle iletişime geçmelidir.
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 sağlanan bilgileri kullanarak satıcıları Google Haritalar'daki yerlerle eşleştireceği için çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. (isteğe bağlı)
serviceAttribute[]

object (ServiceAttribute)

Bu satıcının Hizmetleri'ni açıklamak için kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı)
waitlistAdvisement

object (Advisement)

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan bir kullanıcıya belirli bir satıcıdan gönderilen genel tavsiyeler. Önerideki her bir metin alanının uzunluğu 100 bayt ile sınırlı olmalıdır.
economicOperator

object (EconomicOperator)

İsteğe bağlı. Yasal düzenlemelere uygunluk için bu satıcıyla ilişkili ekonomik işletme bilgileri (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 büyüyeceğ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ş bırakılırsa hiçbir kredi kartı desteklenmez.

CreditCardType

Kredi kartı türü.

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

PaymentOption

Satıcı tarafından sağlanan hizmetler için ödeme yapmak üzere 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ında geçerlidir. Bir değerin birden fazla satıcıda yeniden kullanılması, kullanıcının bu satıcılarda ilgili ödeme seçeneğiyle ödeme yapmasına olanak tanır.

Bir kimliği birden fazla satıcıda yeniden kullandığınızda, bir satıcının altındaki ödeme seçeneğinin herhangi bir değerini güncellediğinizde, farklı bir satıcının altındaki aynı kimliğe sahip diğer ödeme seçenekleri de güncellenir. Bu nedenle, olumsuz davranış olasılığını önlemek için tüm ödeme seçeneklerinin aynı kimliği paylaşan tüm ödeme seçeneklerinin her zaman aynı değerlere güncellenmesini sağlamanız önerilir.
name

string

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

string

Ödeme seçeneğinin açıklaması. Kullanıcılar 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ı veya Hizmet'te bulunan taxRate alanı geçersiz kılınır. Boş bir mesaj (ör. taxRate { }) uygulanan vergi oranını sıfıra sıfırlar.
paymentOptionType

enum (PaymentOptionType)

Bu ödeme seçeneğinin türü. Lansmanlar için tek kullanım, paketler için çoklu kullanım ve üyelikler için sınırsızdır.
sessionCount

string (int64 format)

Bu ödeme seçeneğinin kullanılabileceği oturum sayısı. Yalnızca çok oturumlu/paketler için geçerlidir. Bu durumda değer > 1 olmalıdır.
purchaseInterval

object (TimeRange)

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

object (TimeRange)

Ödeme seçeneği bu aralık içinde kullanılabilir (ör. Ocak 2017 için özel fiyat). Bu özellik mevcutsa, currentDuration ve activitiesType'ı 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 kesir basamağı olan 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 belirlendiğini tanımlar.
userRestriction

object (UserPurchaseRestriction)

Bu ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar. Promosyon amaçlı bir ödeme seçeneğini kullanıcıların bir alt kümesiyle sınırlamak için kullanılabilir. Politika ayarlanmazsa tüm kullanıcılar programa katılmaya uygun olur.

PaymentOptionType

Ödeme seçeneği türüdü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 Ödeme seçeneği, oturum sayısı > 0
PAYMENT_OPTION_UNLIMITED Ödeme seçeneği, geçerli zaman aralığı içinde 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ılmayan.
ACTIVATION_ON_PURCHASE Geçerlilik, satın alma işlemi gerçekleştiğinde başlar.
ACTIVATION_ON_FIRST_USE Geçerlilik, ödeme seçeneği ilk kez kullanıldığında başlar.

UserPurchaseRestriction

Ödeme seçeneği 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 hiç alışveriş yapmamış kullanıcıların satın alabileceği bir ödeme seçeneğidir.
newToPaymentOption

boolean

Yalnızca aynı ödeme seçeneğini daha önce hiç satın almamış kullanıcılar tarafından satın alınabilen bir ödeme seçeneğidir.

PaymentProcessorConfig

Satıcıya göre ayarlanan bir ödeme işleyici yapılandırması.

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şleyici iş ortağını tanımlar.
publicKey

string

Bu satıcıyı ödeme işleyiciyle 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şleyici iş ortağı tanımlar.

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

TokenizationConfig

Satıcı bazında ayarlanan, ödeme işleyici jeton oluşturma yapılandırması.

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

map (key: string, value: string)

Tokenleştirme yapılandırmasında genellikle anahtarı "ağ geçidi" olan bir tokenizationparametresi bulunur ve değeri işleyenin adı olur.

Parametrelerin geri kalanı işlemciye bağlıdır. Daha fazla bilgi için Google Pay'in belgelerine bakın.

Braintree örneği: tokenizationparameter { key: "gateway" değer: "braintree" } tokenizationParameter { key: "braintree:apiVersion" değer: "v1" } tokenizationParameter { key: "braintree:sdkVersion" değer: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" değer: "abcdef" } tokenizationParameter { key: "braintree:clientKey" değer: "Üretim_xxx_yyy" }

Stripe örneği: tokenizationparameter { key: "gateway" değer: "çizgi" } tokenizationParameter { key: "stripe:version" değer: "28-02-2018" } tokenizationParameter { key: "stripe:publishableKey" değer: "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)

Kullanıcının ödeme jetonuna, kullanıcının ödeme şekli ile birlikte Google Pay'e girdiği fatura bilgilerini ekleyin (yukarıya bakın). Alanı boş bırakmak, MIN belirtmekle eşdeğerdir.

BillingInformationFormat

Kullanıcıdan istenecek ve jetona eklenecek Fatura Adresi'nin ne kadarı. Sıralama değerleri, Google Pay API'deki parametrelere karşılık gelir (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'in varsayılan ayarı).
FULL ad, açık adres, konum, bölge, ülke kodu ve posta kodu.

Şartlar

Google ile Rezervasyon üzerinden rezervasyon yapması için kullanıcılara gösterilen kural ve kurallar grubudur.

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 özelliğini 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 Rehber 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 adresine bakın.

ServiceAttribute

Hizmet özellikleri, bir satıcının hizmetlerini tanımlayan iş ortağı tanımlı kategorilerdir. Örneğin, bir banka "Hesap Türü" tanımlayabilir. hizmet özelliği özelliği olup olası "Personal" (Kişisel) değerlerine sahip hizmet özelliği ve "İşletme" ifadelerini içerirken bir kuaför "Hizmet Türü"nü tanımlayabilir. service [Saç Kesimi", "Renk" ve "Stil" gibi değerlere sahip olabileceğini lütfen unutmayın.

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

string

Aynı satıcının diğer hizmet özellikleri arasında bu hizmet özelliğini 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 kullanılabilecek 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 diğer değerler arasında bu değeri benzersiz şekilde tanımlayan bir tanımlayıcı (ör. "kişisel").
valueName

string

Değer için kullanıcının görebildiği ad (ör. "Kişisel".

Tavsiye

Google ile Rezervasyon üzerinden rezervasyon yapıldığında kullanıcıya gösterilen öneriler.

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

object (Text)

Google ile Rezervasyon üzerinden rezervasyon yapıldığında 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. Ürünlerin üretimi, kullanıma sunulması veya hizmete sunulması ile ilgili yükümlülüklere tabi olan üretici, yetkili temsilcisi, ithalatçı, distribütör, sipariş karşılama hizmeti sağlayıcısı veya diğer herhangi bir gerçek ya da tüzel kişi olarak tanımlanan ekonomik operatörün adı, adresi, telefon numarası ve e-posta adresi. economicOperator özelliğinin serbest biçimli dize gösterimi. Bu bilgiler " " ve "\n".

Yöntemler

create

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

delete

 Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant'yi siler.

getStatus

 Merchant tutarından MerchantStatus kazanın.

patch

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