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)
  }
}
Alanlar
name

string

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

merchantName

string

Satıcı adı, telefon, URL ve coğrafi bölge bilgileri, iş ortağı envanterinin halihazırda Google Haritalar'da bulunan satıcılarla eşleştirilmesini 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ı da dahil olmak üzere 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 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ır veya 0 olarak ayarlanırsa bu satıcı tarafından sağlanan tüm hizmetler için kullanıcıdan alınan toplam fiyat Service.price tarafından belirtilen tam fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya zaten bu vergilere dahil olduğu varsayılır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilmez.

Bu alan sıfır dışında bir değere ayarlanırsa bu satıcı tarafından sağlanan tüm hizmetler için kullanıcıdan alınan toplam fiyat, hizmet fiyatı ile burada belirtilen vergi oranı kullanılarak değerlendirilen vergiyi içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri) en yakın eşit yuvarlama kullanılarak yuvarlanır. Vergiler kullanıcıya ayrı bir satır öğesi olarak gösterilir.

Bu alan kullanımdan kaldırıldı. Lütfen bunun yerine vergi oranını kullanın.

taxRate

object (TaxRate)

Satıcının vergi oranı. Bu alan varsa, desteği sonlandırılmış taxRateBasisPoints alanı geçersiz kılınır. 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 ayarlanmazsa herhangi bir kısıtlamanın mevcut olmadığını varsayarız.

paymentOption[]

object (PaymentOption)

Bu satıcının kullanabileceği ödeme seçenekleri. Bu satıcının altındaki hizmetler, izin verdiği ödeme seçeneklerini ayrı ayrı sınırlandırabilir.

paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

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

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. Bunlara ek olarak, toplayıcı iş ortağının Hükümler ve Koşulları da kullanıcıya her zaman gösterilir ve burada belirtilmemelidir.

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üketiciye yönelik yalnızca bir iş ortağı markası varsa bu alanın ayarlanması gerekmez ve yoksayılabilir.

İş ortağı...

Tüketiciye 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

Dikkatli Not: Ç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ı için Hizmetler'i tanımlamak üzere kullanılan hizmet özelliklerinin tanımları. (isteğe bağlı)

waitlistAdvisement

object (Advisement)

İsteğe bağlı. Google ile Rezervasyon üzerinden bekleme listesine katılan kullanıcılar için belirli bir satıcı tarafından verilen genel öneriler. Önerideki her bir metin alanının uzunluğu 100 bayt ile sınırlı olmalıdır.

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 ayarlanmazsa tüm kredi kartlarının kabul edildiğini varsayarız. CreditCardType tarafından desteklenen kart listesinin zamanla büyüyeceğini, bu nedenle bu boş alanın gelecekte değişiklikler yapılmasına yol açabileceğini unutmayın.

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 çok satıcı (ör. aynı zincirdeki satıcılar) arasında 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, bu ö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ı için tekrar kullanırken bir satıcının altındaki ödeme seçeneğinin değerini güncellediğinizde, farklı bir satıcı altında aynı kimliğe sahip diğer tüm ö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ı. Kullanıcılar 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 çoklu oturum / paketler için geçerlidir. Değerin > olması gerekir 1.

purchaseInterval

object (TimeRange)

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

validInterval

object (TimeRange)

Ödeme seçeneği bu aralıkta 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 belirleneceğini tanımlar.

userRestriction

object (UserPurchaseRestriction)

Bu ödeme seçeneğini satın almaya uygun kullanıcıları kısıtlar. Bir kullanıcı alt kümesinin promosyonlu ödeme seçeneğini kısıtlamak 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ılmayan.
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ığında kullanılabilir. Oturum sayısı geçerli değildir.

ActivationType

Geçerlilik başlangıç tarihinin nasıl belirlendiğ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ı bazında ayarlanan ö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 sayfasını ziyaret edin: 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 yapılandırma.

TokenizationConfig

Satıcı bazında ayarlanan ödeme işleyici jetonlara ayırma yapılandırması.

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

map (key: string, value: string)

Jetonlara ayırma 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: tokenizationParametresi { 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: tokenizationparametresi { key: "gateway" değer: "adyen" } tokenizationParameters { key: "gatewayMerchantId" value: "kimliğiniz" }

"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 MİN 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'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 Rehber veritabanındaki ve Google Haritalar'daki 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ı için Hizmetler'i tanımlayan iş ortağı tarafından tanımlanan kategorilerdir. Örneğin, bir banka "Hesap Türü" tanımlayabilir. hizmet özelliği özelliği olup potansiyel "Personal" (Kişisel) değerine sahip 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ı için bu hizmet özelliğini diğerleriyle benzersiz şekilde tanımlayan bir tanımlayıcı (ör. hesap türü.

attributeName

string

Bu özellik için kullanıcının görebildiği 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 bu değeri diğerleriyle 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.

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 öğesini 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.