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

partners/{partner_id}/merchants/{merchantId} biçiminde olan satıcı kaynak adı.

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

string

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

string

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

object (GeoCoordinates)

Satıcının enlem, boylam ve adres dahil olmak üzere coğrafi bilgileri.

string

Toplayıcının platformundaki işletmenin kategorisi.

string (int64 format)

Bu alan kullanımdan kaldırılmıştır.

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.

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.

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.

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.

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

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.

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.

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

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

object (ActionLink)

İsteğe bağlı. İlişkili dil, kısıtlanmış ülkelerin listesi, tür ve bu işlemin hangi platformda gerçekleştirileceğini belirten isteğe bağlı platform içeren bir işlem URL'si,

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.

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

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

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

enum (CreditCardType)

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

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

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.

string

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

string

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

object (Price)

Ödeme seçeneğinin fiyatı.

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.

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.

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.

object (TimeRange)

Ödeme seçeneği bu aralık içinde satın alınabilir.

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.

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

enum (ActivationType)

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

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.

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

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.

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.

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

enum (Processor)

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

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

string

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

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

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

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.

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

string

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

string

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

object (Text)

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

{
  "placeId": string
}

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.

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

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

string

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

object (Value)

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

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

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

string

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

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

object (Text)

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

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