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

string

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

string

merchantName, telefon, url ve coğrafya bilgileri, 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ı.

string

Ülke ve alan kodları dahil olmak üzere satıcının 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 gibi coğrafi konum bilgileri.

string

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

string (int64 format)

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

integer (uint32 format)

Satıcının puan cinsinden vergi oranı (yüzde birin yüzde 100'ü). Ö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 herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, tam olarak Service.price tarafından belirtilen fiyat olur. Hizmet fiyatının geçerli vergilerden muaf olduğu veya 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 herhangi bir hizmet için kullanıcıdan alınan toplam fiyat, hizmet fiyatının yanı sıra burada sağlanan vergi oranı kullanılarak hesaplanan vergiyi de içerir. En küçük para biriminin kesirleri (ör. bir sentin kesirleri), en yakın çift 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 taxRate değerini kullanın.

object (TaxRate)

Satıcının vergi oranı. Mevcutsa bu alan kullanımdan kaldırılan taxRateBasisPoints alanını geçersiz kılar. Boş bir mesaj (vergi yüzdesi { }) uygulanan vergi oranını sıfır olarak ayarlar.

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 olmadığını varsayarız.

object (PaymentOption)

Bu satıcı için ödeme seçenekleri mevcut. Bu satıcı kapsamındaki hizmetler, izin verdikleri ödeme seçeneklerini ayrı ayrı sınırlandırabilecek.

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

object (Terms)

Google ile Rezervasyon üzerinden bir hizmet rezervasyonu yapıldığında kullanıcıya gösterilen, satıcının Şartlar ve Koşulları. Bunlara ek olarak, toplayıcı iş ortağının Şartlar ve Koşulları kullanıcıya her zaman gösterilir ve burada sunulmamalıdır.

string

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

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

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

İş ortağı...

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

Yapılandırılmış Birden Çok Markanız 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. Bu alanı kullanmak isteyen bir iş ortağı, varsayılan marka dahil olmak üzere ayrı markalar yapılandırmak için öncelikle bizimle iletişime geçmelidir.

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ı gerekmez. (isteğe bağlı)

object (ServiceAttribute)

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

object (ActionLink)

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

object (Advisement)

İsteğe bağlı. Belirli bir satıcıdan, Google ile Rezervasyon üzerinden bekleme listesine katılan kullanıcılar için genel öneriler. Önerideki bağımsız metin alanları 100 baytla sınırlı olmalıdır.

{
  "creditCardRestrictions": {
    object (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 varsayıyoruz. CreditCardType tarafından desteklenen kart listesinin zamanla artacağını unutmayın. Bu alanı boş bırakırsanız gelecekteki değişiklikler için yapılandırma söz konusu olur.

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

enum (CreditCardType)

Desteklenen kredi kartlarının listesi. Boş olması halinde hiçbir 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, bu ödeme seçeneğini tanımlamak için kullanılır.

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

Bir kimliği birden çok satıcı için yeniden kullanırken, bir satıcı altındaki ödeme seçeneğinin değeri güncellendiğinde farklı bir satıcı altında aynı kimliğe sahip diğer tüm ödeme seçenekleri de güncellenir. Bu nedenle, zarar verici davranış olasılığından kaçınmak için tüm ödeme seçeneklerinin aynı kimliği paylaşması ve her zaman aynı değerlere güncellenmesi önerilir.

string

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

string

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

object (Price)

Ödeme seçeneğinin fiyatı.

object (TaxRate)

Bu ödeme seçeneği için vergi oranı. Mevcutsa bu alan, Satıcı veya Hizmet'te bulunan taxRate alanını geçersiz kılar. Boş bir mesaj (vergi yüzdesi { }) uygulanan vergi oranını sıfır olarak ayarlar.

enum (PaymentOptionType)

Bu ödeme seçeneğinin türü. Üyelikler için tek kullanım, paketler için çok kullanım ve üyelikler için sınırsız.

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

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

string (Duration format)

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

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir 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. Bir kullanıcı alt kümesiyle promosyon ödeme seçeneğini kısıtlamak için kullanılabilir. Politika ayarlanmazsa tüm kullanıcılar uygun olur.

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

boolean

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

boolean

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

{
  "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 sayfasına bakın. 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)

Jetonlara ayırma yapılandırmasında genellikle anahtarı "ağ geçidi", değeri ise işlemcinin adı olan bir tokenizasyon parametresi bulunur.

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

Braintree örneği: tokenizasyon Parametresi { key: "gateway" value: "braintree" } tokenizasyon Parametresi { key: "braintree:apiVersion" value: "v1" } tokenizasyon Parametresi { key: "braintree:xxVersion" value: "2.30.0" } tokenizasyon Parametresi { key: "braintree" {intyree" tokenizleştirme Parametresi { key: "braintree" {intyree} "abcdedikey":

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

Adyen örneği: tokenizasyon Parametresi { key: "gateway" value: "adyen" } tokenizationParameters { key: "gatewayMerchantId" value: "yourId" }

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

enum (BillingInformationFormat)

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

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

string

İsteğe bağlı olarak, Şartlar ve Koşullar'ın URL'si.

string

Kullanıcıya gösterilecek metin. Yeni entegrasyonlar için aşağıdaki localizedText'i 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 hizmet özelliğini diğer özellikler arasında benzersiz bir şekilde tanımlayan bir tanımlayıcı (ör. "hesap türü").

string

Bu özellik için kullanıcı tarafından görülebilen bir ad (ör. "Hesap Türü").

object (Value)

Bu hizmet özelliğiyle ilgili olası tüm değerler.

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

string

Bu hizmet özelliğiyle ilgili olarak bu değeri diğerleriyle birlikte benzersiz bir şekilde tanımlayan bir tanımlayıcı (ör. "kişisel").

string

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

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

object (Text)

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