- Kaynak: Satıcı
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- İşlemci
- TokenizationConfig
- BillingInformationFormat
- Şartlar
- MerchantMatchingHints
- ServiceAttribute
- Değer
- Tavsiye
- Yöntemler
Kaynak: Satıcı
Toplayıcının platformunda bulunan satıcı hakkında bilgiler.
JSON gösterimi |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Alanlar | |
---|---|
name |
|
merchantName |
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ı. |
telephone |
Ülke ve alan kodları dahil olmak üzere satıcının herkese açık telefon numarası, ör. +14567891234. |
url |
Satıcının herkese açık web sitesinin URL'si. |
geo |
Satıcının enlem, boylam ve adres gibi coğrafi konum bilgileri. |
category |
Toplayıcının platformundaki işletme kategorisi. |
numBookings30d |
Bu alan kullanımdan kaldırılmıştır. |
taxRateBasisPoints |
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. |
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. |
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. |
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. |
paymentProcessorConfig |
Satıcının destek hizmeti varsa token atanmış ödeme işleyici için yapılandırma. |
tokenizationConfig |
Satıcının destek hizmeti varsa token atanmış ödeme işleyici için yapılandırma. |
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. |
brandId |
İş 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?
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. |
matchingHints |
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ı) |
serviceAttribute[] |
Bu Satıcı için Hizmetler'i açıklamak üzere kullanılan tüm hizmet özelliklerinin tanımları. (isteğe bağlı) |
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, |
waitlistAdvisement |
İ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. |
PaymentRestrictions
Bu satıcının kabul ettiği ödeme yöntemleriyle ilgili kısıtlamalar.
JSON gösterimi |
---|
{
"creditCardRestrictions": {
object ( |
Alanlar | |
---|---|
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. |
CreditCardRestrictions
Bu satıcının kabul ettiği kredi kartı türleriyle ilgili kısıtlamalar.
JSON gösterimi |
---|
{
"creditCardType": [
enum ( |
Alanlar | |
---|---|
creditCardType[] |
Desteklenen kredi kartlarının listesi. Boş olması halinde hiçbir 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 çok satıcı (ör. aynı zincire ait satıcılar) arasında paylaşılabilir.
JSON gösterimi |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Alanlar | |
---|---|
paymentOptionId |
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. |
name |
Ödeme seçeneğinin adı. Bu öğe, kullanıcılar tarafından görülebilir. |
description |
Ödeme seçeneğinin açıklaması. Bu öğe, kullanıcılar tarafından görülebilir. |
price |
Ödeme seçeneğinin fiyatı. |
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. |
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. |
sessionCount |
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. |
purchaseInterval |
Ödeme seçeneği bu zaman aralığında satın alınabilir. |
validInterval |
Ö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. |
validDuration |
Ödeme seçeneğinin geçerlilik süresi (ör. 30 günlük üyelik). En fazla dokuz kesir basamağı içeren ve " |
activationType |
Bu ödeme seçeneği için geçerlilik başlangıç tarihinin nasıl belirlendiğini tanımlar. |
userRestriction |
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. |
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 |
Oturum sayısı 0'dan büyükse ödeme seçeneği kullanılabilir. |
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ılmamış. |
ACTIVATION_ON_PURCHASE |
Geçerlilik süresi, satın alma işlemi gerçekleştiğinde başlar. |
ACTIVATION_ON_FIRST_USE |
Geçerlilik süresi, ö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 |
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. |
newToPaymentOption |
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. |
PaymentProcessorConfig
Ödeme işleyiciye yönelik bir yapılandırma ve her satıcı için ayrı ayrı ayarlanır.
JSON gösterimi |
---|
{
"processor": enum ( |
Alanlar | |
---|---|
processor |
Bu yapılandırmanın geçerli olduğu ödeme işleyici iş ortağını tanımlar. |
publicKey |
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 |
version |
Ö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 ödemelere yönelik bir yapılandırma. |
PROCESSOR_BRAINTREE |
Braintree ile ödemeler için bir yapılandırma. |
TokenizationConfig
Ödeme işleyici jetonlara ayırma yapılandırması için Satıcı başına ayrı olarak ayarlanır.
JSON gösterimi |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Alanlar | |
---|---|
tokenizationParameter |
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" }
|
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. |
BillingInformationFormat
Kullanıcıdan istenecek ve jetona dahil edilecek Fatura Adresi ne kadardır. Sıralama değerleri, Google Pay API'deki parametrelere karşılık gelir (bkz. 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 varsayılan ayarı). |
FULL |
ad, açık adres, semt, bölge, ülke kodu ve posta kodu. |
Terimler
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 ( |
Alanlar | |
---|---|
url |
İsteğe bağlı olarak, Şartlar ve Koşullar'ın URL'si. |
text |
Kullanıcıya gösterilecek metin. Yeni entegrasyonlar için aşağıdaki localizedText'i kullanın. |
localizedText |
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 |
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 açıklayan, iş ortağı tanımlı kategorilerdir. Örneğin, bir banka "Kişisel" ve "İş" gibi olası değerleri içeren bir "Hesap Türü" hizmet özelliği tanımlarken bir kuaför, "Saç Kesimi", "Renk" ve "Stil" değerlerini içeren bir "Hizmet Türü" hizmet özelliği tanımlayabilir.
JSON gösterimi |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Alanlar | |
---|---|
attributeId |
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ü"). |
attributeName |
Bu özellik için kullanıcı tarafından görülebilen bir ad (ör. "Hesap Türü"). |
value[] |
Bu hizmet özelliğiyle ilgili olası 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 |
Bu hizmet özelliğiyle ilgili olarak bu değeri diğerleriyle birlikte benzersiz bir şekilde tanımlayan bir tanımlayıcı (ör. "kişisel"). |
valueName |
Değer için kullanıcı tarafından görülebilen ad (ör. "Kişisel"). |
Danışmanlık
Google ile Rezervasyon üzerinden rezervasyon sırasında kullanıcıya gösterilen öneriler.
JSON gösterimi |
---|
{
"text": {
object ( |
Alanlar | |
---|---|
text |
Google ile Rezervasyon üzerinden rezervasyon sırasında kullanıcıya gösterilecek özel mesaj. |
Yöntemler |
|
---|---|
|
Belirtilen toplayıcı tarafından yönetilen yeni bir Merchant oluşturur ve bunu döndürür. |
|
Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant öğesini siler. |
|
Merchant ile MerchantStatus kazanın. |
|
Belirtilen toplayıcı tarafından yönetilen mevcut bir Merchant değerini günceller ve bunu döndürür. |