REST Resource: inventory.partners.merchants

Kaynak: Satıcı

Toplayıcının platformunda bulunan bir 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çiminde olan satıcı kaynak 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 vergi oranı, baz puan cinsinden (yüzdenin yüzde biri). Ö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 desteklediği durumlarda jetonlu ödeme işleyici yapılandırması.

terms

object (Terms)

Google ile Rezervasyon aracılığıyla bir hizmet rezervasyonu yapılırken kullanıcıya gösterilen ilgili satıcının 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örüntülerken 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'deki 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 bu alan yoksayılabilir.

İş ortağı:

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

Yapılandırılmış birden fazla marka 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

Dikkat: Çoğu iş ortağının bu alanı ayarlamasına gerek yoktur. Bu alanı kullanmak isteyen iş ortaklarının, varsayılan marka da dahil olmak üzere ayrı markaları yapılandırmak için önce bizimle iletişime geçmesi gerekir.

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ğinden ç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. Tavsiyedeki metin alanları 100 baytla 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şsa kredi kartı 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 Discover kredi kartı.
JCB JCB kredi kartı.

PaymentOption

Satıcı tarafından sağlanan hizmetler için ödeme yapmak üzere kullanılabilen 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 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, tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlerle güncellenmesi, kötüye kullanım olasılığı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ı veya Hizmet'te bulunan taxRate alanını geçersiz kılar. 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ü. Tek kullanımlık, paketler için çok kullanımlık ve üyelikler için sınırsız.

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 aralık içinde 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). Mevcut olduğunda validDuration ve activationType parametrelerini 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 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. Ayarlanmazsa tüm kullanıcılar uygun olur.

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 Ödeme seçeneği, oturum sayısı 0'dan büyükse kullanılabilir.
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ılmamış.
ACTIVATION_ON_PURCHASE Geçerlilik, 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

Bir ö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 hiç satın alma işlemi gerçekleştirmemiş kullanıcılar tarafından kullanılabilen bir ödeme seçeneği.

newToPaymentOption

boolean

Yalnızca 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

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ğını 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)

Bir jeton oluşturma yapılandırmasında genellikle anahtarı "gateway" olan ve değeri işleyicinin adı olan bir tokenizationParameter bulunur.

Parametrelerin geri kalanı 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 jetonuna, kullanıcının FOP ile Google Pay'e girdiği fatura bilgilerini ekleyin (yukarıya bakın). Alanı boş bırakmak, MIN değerini belirtmeye eşdeğerdir.

BillingInformationFormat

Kullanıcıdan istenecek ve jetona dahil edilecek fatura adresinin ne kadarı. Enum değerleri, Google Pay API'sindeki parametrelere karşılık gelir (https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters) adresine bakın).

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 kurallar ve yönergeler grubu.

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ı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ının hizmetlerini tanımlayan iş ortağı tanımlı kategorilerdir. Örneğin, bir banka "Hesap Türü" hizmet özelliğini "Kişisel" ve "İşletme" olası değerleriyle tanımlayabilir. Bir kuaför ise "Hizmet Türü" hizmet özelliğini "Saç Kesimi", "Renk" ve "Stil" olası değerleriyle tanımlayabilir.

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ı tarafından görülebilen bir ad (ör. "Kişisel").

Tavsiye

Google ile Rezervasyon üzerinden rezervasyon yapılırken kullanıcıya gösterilen tavsiyeler.

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

object (Text)

Google ile Rezervasyon üzerinden rezervasyon yapılırken 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ün üretme, kullanıma sunma ya da kullanıma alma ile ilgili yükümlülüklere tabi olan diğer herhangi bir gerçek veya tüzel kişi olarak tanımlanan ekonomik işletmecinin adı, adresi, telefon numarası ve e-posta adresi. economicOperator özelliğinin 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'yi siler.

getStatus

Bir Merchant'un MerchantStatus değerini alın.

patch

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