- HTTP isteği
- İstek gövdesi
- Yanıt metni
- İşleyici
- Amaç
- IntentParameterValue
- Sahne
- SlotFillingStatus
- Slot
- SlotMode
- SlotStatus
- İstem
- Basit
- İçerik
- Kart
- Resim
- ImageFill
- Bağlantı
- OpenUrl
- UrlHint
- Tablo
- TableColumn
- HorizontalAlignment
- TableRow
- TableCell
- Medya
- MediaType
- OptionalMediaControls
- MediaObject
- MediaImage
- RepeatMode
- Koleksiyon
- CollectionItem
- Liste
- ListItem
- CollectionBrowse
- Öğe
- Öneri
- Kanvas
- ContinuousMatchConfig
- ExpectedPhrase
- OrderUpdate
- Tür
- Sipariş
- Kullanıcı Bilgileri
- PhoneNumber
- Resim
- Satıcı
- Yer
- LatLng
- PostalAddress
- İçindekiler
- LineItem
- PriceAttribute
- Tür
- Durum
- Para
- İşlem
- Tür
- OpenUrlAction
- AndroidApp
- VersionFilter
- UrlTypeHint
- ActionMetadata
- Açıklama
- DisclosureText
- TextLink
- DisclosurePresentationOptions
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- Birim
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- Tür
- Zaman
- PickupInfo
- PickupType
- CurbsideInfo
- CurbsideFulfillmentType
- Araç
- CheckInInfo
- CheckInType
- ItemOption
- ProductDetails
- ReservationItemExtension
- ReservationStatus
- ReservationType
- StaffFacilitator
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- PaymentType
- PaymentMethodProvenance
- Tanıtım
- PurchaseOrderExtension
- PurchaseLocationType
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- Tür
- EventCharacter
- Tür
- UserNotification
- NextScene
- Oturum
- TypeOverride
- TypeOverrideMode
- SynonymType
- Giriş
- EntryDisplay
- Kullanıcı
- AccountLinkingStatus
- UserVerificationStatus
- Etkileşim
- IntentSubscription
- PackageEntitlements
- Yararlanma hakkı
- SkuType
- SignedData
- İzin
- Ana sayfa
- Cihaz
- Kapasite
- Yer
- TimeZone
- Bağlam
- MediaContext
- CanvasContext
- Beklenen
Karşılama API'sini temsil eden TBG
HTTP isteği
POST https://webhook_handler_service.googleapis.com/fulfill
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek gövdesi aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi | |
---|---|
{ "handler": { object ( |
Alanlar | |
---|---|
handler |
Zorunlu. İsteğin nasıl ele alınacağına ilişkin bilgiler. Örneğin, bilgi edinmeyi amaçlayan bir istekte "getFact" adında bir işleyici olabilir. |
intent |
Zorunlu. Son eşleşen amacı gösterir. https://developers.google.com/assistant/conversational/intents adresine göz atın. |
scene |
İsteğe bağlı. İşlev çağrıldığında mevcut ve bir sonraki sahne hakkında bilgiler. Sipariş karşılama çağrısı bir sahne kapsamında yapıldığında doldurulur. https://developers.google.com/assistant/conversational/scenes adresine göz atın. |
session |
Zorunlu. Oturum kimliği ve oturum parametreleri gibi oturum verilerini muhafaza eder. |
user |
Zorunlu. Görüşmeyi başlatan kullanıcı. |
home |
İsteğe bağlı. Hedef cihazın ait olduğu HomeGraph yapısıyla ilgili bilgiler. https://developers.google.com/actions/smarthome/concepts/homegraph adresini ziyaret edin. |
device |
Zorunlu. Kullanıcının İşlem ile etkileşimde bulunmak için kullandığı cihazdaki bilgiler. |
context |
İsteğe bağlı. Talebin mevcut bağlamıyla ilgili bilgiler. Etkin medya oturumu bilgilerini veya tuval bilgilerini içerir ancak bunlarla sınırlı değildir. |
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Bir geliştiricinin Actions on Google'a karşılamasından sonra gönderilen yanıtı temsil eder.
JSON gösterimi | |
---|---|
{ "prompt": { object ( |
Alanlar | |
---|---|
prompt |
İsteğe bağlı. Kullanıcıya gönderilecek istemleri temsil eder. Bu istemler, açıkça üzerine yazılmadığı sürece önceden eklenen mesajlara eklenir. |
scene |
İsteğe bağlı. Geçerli ve sonraki sahneyi temsil eder. |
session |
İsteğe bağlı. Geçerli oturumla ilgili verileri açıklar. Oturum parametreleri, istek karşılama tarafından oluşturulabilir, güncellenebilir veya kaldırılabilir. |
user |
İsteğe bağlı. Geri gönderilecek kullanıcı parametrelerini belirtmek için kullanın. |
home |
İsteğe bağlı. Hedef cihazın ait olduğu HomeGraph yapısıyla ilgili parametreleri belirtmek için kullanılır. https://developers.google.com/actions/smarthome/concepts/homegraph adresini ziyaret edin. |
device |
İsteğe bağlı. Kullanıcının erişebildiği Asistan cihazları arasında geçiş yapmak için kullanın. |
expected |
İsteğe bağlı. Bir sonraki diyalog dönüşü için beklentileri açıklar. |
İşleyici
Actions on Google'daki etkinlik bilgilerini sipariş karşılama ile eşleyen bir sipariş karşılama işleyiciyi temsil eder. İstek karşılamada hangi kodu çalıştırmanız gerektiğini belirlemek için işleyici adını kullanın. Örneğin, bir işleyici, "OrdersLookup" gibi bir işleyici adıyla birlikte bir kullanıcının sipariş bilgilerini almak için kullanılabilir. diğeri ise "GetProductInfo" gibi bir işleyici adıyla veritabanından ürün bilgilerini alabilir.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
İsteğe bağlı. İşleyicinin adı. |
Amaç
Niyeti temsil eder. https://developers.google.com/assistant/conversational/intents adresine göz atın.
JSON gösterimi | |
---|---|
{
"name": string,
"params": {
string: {
object ( |
Alanlar | |
---|---|
name |
Zorunlu. Son eşleşen amacın adı. |
params |
Zorunlu. Amaç eşleştirmenin bir parçası olarak tanımlanan parametreleri temsil eder. Bu, tanımlanan parametrenin adı ile kullanıcı girişinden tanımlanan parametrenin değerinin eşleştirilmesidir. Eşleşen amaçta tanımlanan ve tanımlanan tüm parametreler burada gösterilir.
|
query |
İsteğe bağlı. Bu amaçla eşleşen son kullanıcının yazdığı veya sözlü olarak girdiği giriş. Bu alan, kullanıcı girişine göre bir amaç eşleştiğinde doldurulur. |
IntentParameterValue
Amaç parametresi için bir değeri temsil eder. https://developers.google.com/assistant/conversational/types adresine göz atın.
JSON gösterimi | |
---|---|
{ "original": string, "resolved": value } |
Alanlar | |
---|---|
original |
Zorunlu. Orijinal metin değeri kullanıcının söylediklerinden alındı. |
resolved |
Zorunlu. Kullanıcı girişinden çıkarılan parametrenin yapılandırılmış değeri. Bu alan yalnızca parametre, eşleşen amaçta tanımlıysa ve parametre değeri intent eşleştirme sırasında tanımlanabilirse doldurulur. |
Sahne
Bir sahneyi temsil etme. Sahneler, karşılama çağrısı yapabilir, istem ekleyebilir ve kullanıcıdan alan değerlerini toplayabilir. Sahneler etkinlikler veya amaçlar tarafından tetiklenir ve diğer sahnelere geçiş için etkinlikleri tetikleyip amaçları eşleştirebilir.
JSON gösterimi | |
---|---|
{ "name": string, "slotFillingStatus": enum ( |
Alanlar | |
---|---|
name |
Zorunlu. Geçerli sahnenin adı. |
slotFillingStatus |
Zorunlu. Boşluk doldurma işleminin mevcut durumu. Bu alan salt okunurdur. |
slots |
Geçerli sahneyle ilişkilendirilen alanlar. İşleyici yanıtları, istekte gönderilmeyen alanları döndüremez.
|
next |
İsteğe bağlı. Sıradaki yürütülecek sahnedeki bilgiler. |
SlotFillingStatus
Boşluk doldurmanın mevcut durumunu gösterir.
Sıralamalar | |
---|---|
UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
INITIALIZED |
Alanlar başlatıldı ancak alan doldurma başlamadı. |
COLLECTING |
Alan değerleri toplanıyor. |
FINAL |
Tüm alan değerleri nihaidir ve değiştirilemez. |
Alan
Bir alanı temsil eder.
JSON gösterimi | |
---|---|
{ "mode": enum ( |
Alanlar | |
---|---|
mode |
Alan modu (zorunlu veya isteğe bağlı). Geliştirici tarafından ayarlanabilir. |
status |
Zaman aralığının durumu. |
value |
Alanın değeri. Yanıtta bu değerin değiştirilmesi, alan doldurmadaki değeri değiştirir. |
updated |
Slot değerinin son dönüşte toplanıp toplanmadığını gösterir. Bu alan salt okunurdur. |
prompt |
İsteğe bağlı. Bu istem, gerekli bir alanı doldurması gerektiğinde kullanıcıya gönderilir. Bu istem, konsolda tanımlanmış mevcut istemi geçersiz kılar. Bu alan webhook isteğine dahil değildir. |
SlotMode
Bir alanın modunu (zorunlu olup olmadığını) temsil eder.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
OPTIONAL |
Aralıkın, boşluk doldurmayı tamamlamak için gerekli olmadığını gösterir. |
REQUIRED |
Boşluk doldurmayı tamamlamak için zaman aralığının gerektiğini gösterir. |
SlotStatus
Bir alanın durumunu temsil eder.
Sıralamalar | |
---|---|
SLOT_UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
EMPTY |
Alanda herhangi bir değer olmadığını gösterir. Bu durum yanıt aracılığıyla değiştirilemez. |
INVALID |
Alan değerinin geçersiz olduğunu gösterir. Bu durum, yanıt aracılığıyla ayarlanabilir. |
FILLED |
Alanda bir değer olduğunu gösterir. Bu durum yanıt aracılığıyla değiştirilemez. |
İstem
Bir kullanıcıya verilen yanıtı temsil etme. https://developers.google.com/assistant/conversational/prompts adresine göz atın.
JSON gösterimi | |
---|---|
{ "override": boolean, "firstSimple": { object ( |
Alanlar | |
---|---|
override |
İsteğe bağlı. Bu iletilerin önceden tanımlanmış iletilerle birleştirilme şekli. "true" (doğru) önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneri bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "yanlış" bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alan "false" olarak bırakılıyor Basit istemler, Öneriler istemi ve Tuval istemi (İçerik isteminin bir parçası) içindeki bazı alanlara da ekleme yapılabilir. İstemde tanımlanırsa İçerik ve Bağlantı iletilerinin her zaman üzerine yazılır. Varsayılan değer "false"tur. |
firstSimple |
İsteğe bağlı. İlk sesli ve yalnızca metin yanıt. |
content |
İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik. |
lastSimple |
İsteğe bağlı. Son sesli ve yalnızca metin yanıt. |
suggestions[] |
İsteğe bağlı. Kullanıcıya gösterilecek öneriler. Bunlar, her zaman yanıtın sonunda gösterilir. "Geçersiz kıl" alanına "false" (yanlış) değeri eklenirse bu alanda tanımlanan başlıklar, önceden tanımlanmış tüm öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır. |
link |
İsteğe bağlı. İlişkili uygulama veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Aç (ad)" başlığıyla oluşturulur. Maksimum 20 karakter. |
canvas |
İsteğe bağlı. Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. |
orderUpdate |
İsteğe bağlı işlem, işlem akışı sırasında siparişi aldıktan sonra OrderUpdate ile yanıt verir. Google bu güncellemeyi aldıktan sonra siparişe kaydeder ve başarılı olursa görüntüleme cihazlarında gönderilen TTS ile birlikte bir makbuz kartı gösterir. |
Basit
Kullanıcıya gönderilmesi için basit bir istemi temsil eder. https://developers.google.com/assistant/conversational/prompts-simple adresine göz atın.
JSON gösterimi | |
---|---|
{ "speech": string, "text": string } |
Alanlar | |
---|---|
speech |
İsteğe bağlı. Kullanıcıya söylenecek konuşmayı temsil eder. SSML veya metin okuma olabilir. "Geçersiz kıl" alanındaki istem "true" değerine ayarlandığında, bu alanda tanımlanan konuşma önceki Basit istemin konuşmasının yerini alır. https://developers.google.com/assistant/conversational/ssml adresine göz atın. |
text |
Sohbet balonunda görüntülenecek isteğe bağlı metin. Belirtilmezse yukarıdaki konuşma alanının görüntülemesi kullanılır. Uzunluk sınırı 640 karakterdir. "Geçersiz kıl" alanındaki istem "true" ise bu alanda tanımlanan metin önceki Basit istemin metniyle değiştirilir. |
İçerik
Zengin istemler veya seçim istemleri için kapsayıcı nesnesi.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birleştirme alanı
|
||
card |
Temel kart. |
|
image |
Bir resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak bir grup medyayı gösteren yanıt. |
|
collection |
Bir dizi seçenek sunan kart. |
|
list |
Seçebileceğiniz seçeneklerin listesini sunan bir kart. |
|
collectionBrowse |
Açılacak bir web sayfası koleksiyonu sunan kart. |
Kart
Bazı bilgileri görüntülemek için kullanılan temel kart, ör. bir resim ve/veya metin. https://developers.google.com/assistant/conversational/prompts-rich#basic_card adresine göz atın.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Alanlar | |
---|---|
title |
Kartın genel başlığı. İsteğe bağlı. |
subtitle |
İsteğe bağlı. |
text |
Kartın gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimi grubunu destekler. Resim mevcut olmadığı sürece gereklidir. |
image |
Kart için hero resim. Yükseklik 192 dp olarak sabitlendi. İsteğe bağlı. |
imageFill |
Resim arka planının nasıl doldurulacağı. İsteğe bağlı. |
button |
Giden bağlantı içeren düğme. İsteğe bağlı. |
Resim
Kartta bir resim gösteriliyor. https://developers.google.com/assistant/conversational/prompts-rich#image-cards adresini ziyaret edin.
JSON gösterimi | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Resmin kaynak URL'si. Resimler JPG, PNG ve GIF biçiminde (animasyonlu veya animasyonsuz) olabilir. Örneğin, |
alt |
Erişilebilirlik için kullanılacak resmin metin açıklaması, ör. Ekran okuyucular. Zorunlu. |
height |
Resmin piksel cinsinden yüksekliği. İsteğe bağlı. |
width |
Resmin piksel cinsinden genişliği. İsteğe bağlı. |
ImageFill
Resmin sunumunu etkileyecek olası resim görüntüleme seçenekleri. Bu, resmin en boy oranı, görüntü kapsayıcısının en boy oranıyla eşleşmediğinde kullanılmalıdır.
Sıralamalar | |
---|---|
UNSPECIFIED |
|
GRAY |
Resim ile görüntü kapsayıcısı arasındaki boşlukları gri çubuklarla doldurun. |
WHITE |
Resim ile görüntü kapsayıcısı arasındaki boşlukları beyaz çubuklarla doldurun. |
CROPPED |
Resim, genişlik ve yüksekliğinin kapsayıcı boyutlarıyla eşleşecek veya bu boyutların üzerinde olacak şekilde ölçeklendirilir. Bu işlemde, ölçeklendirilmiş resim yüksekliği kapsayıcı yüksekliğinden fazlaysa resmin üst ve alt kısmı kırpılabilir. Ölçeklendirilmiş resim genişliği kapsayıcı genişliğinden fazlaysa resmin sol ve sağ kısmı kırpılabilir. Bu, "Yakınlaştırma Modu"na benzer TV'de 4:3 video oynattığını varsayalım. |
Bağlantı
İlişkili uygulama veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Aç (ad)" başlığıyla oluşturulur.
JSON gösterimi | |
---|---|
{
"name": string,
"open": {
object ( |
Alanlar | |
---|---|
name |
Bağlantının adı. En fazla 20 karakter. |
open |
Kullanıcı bağlantıyı açtığında ne olur? |
OpenUrl
JSON gösterimi | |
---|---|
{
"url": string,
"hint": enum ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls |
hint |
URL türüyle ilgili bir ipucu gösterir. |
UrlHint
Farklı URL ipuçları türleri.
Sıralamalar | |
---|---|
LINK_UNSPECIFIED |
Belirtilmedi |
AMP |
Doğrudan AMP içeriğine veya aracılığıyla AMP içeriğine başvuruda bulunan standart URL'ye yönlendiren URL. https://amp.dev/ sayfasına bakın. |
Tablo
Bir metin tablosunu gösteren tablo kartı. https://developers.google.com/assistant/conversational/prompts-rich#table_cards adresine göz atın.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Alanlar | |
---|---|
title |
Tablonun genel başlığı. İsteğe bağlıdır ancak alt başlık ayarlanmışsa ayarlanmalıdır. |
subtitle |
Tablonun alt başlığı. İsteğe bağlı. |
image |
Tabloyla ilişkilendirilen resim. İsteğe bağlı. |
columns[] |
Başlıklar ve sütunların hizalaması. |
rows[] |
Tablonun satır verileri. İlk 3 satırın gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi satırların gösterileceğini görmek için lütfen simülasyon aracıyla test edin. WEB_BROWSER özelliğini destekleyen yüzeylerde, kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz. |
button |
Düğme. |
TableColumn
JSON gösterimi | |
---|---|
{
"header": string,
"align": enum ( |
Alanlar | |
---|---|
header |
Sütunun başlık metni. |
align |
İçerik sütunuyla yatay hizalama. Belirtilmemişse içerik ön kenarla hizalanır. |
HorizontalAlignment
Hücredeki içeriğin hizalaması.
Sıralamalar | |
---|---|
UNSPECIFIED |
|
LEADING |
Hücrenin ön kenarı. Bu, varsayılan ayardır. |
CENTER |
İçerik, sütunun ortasına hizalanır. |
TRAILING |
İçerik, sütunun son kenarıyla hizalanır. |
TableRow
Tablodaki bir satırı açıklar.
JSON gösterimi | |
---|---|
{
"cells": [
{
object ( |
Alanlar | |
---|---|
cells[] |
Bu satırdaki hücreler. İlk 3 hücrenin gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi hücrelerin gösterileceğini görmek üzere lütfen simülasyon aracıyla test yapın. |
divider |
Her satırdan sonra bir ayırıcı olması gerekip gerekmediğini belirtir. |
TableCell
Bir satırdaki bir hücreyi açıklar.
JSON gösterimi | |
---|---|
{ "text": string } |
Alanlar | |
---|---|
text |
Hücrenin metin içeriği. |
Medya
Bir medya nesnesini temsil eder. Medya hakkında ad, açıklama, URL gibi bilgiler içerir. https://developers.google.com/assistant/conversational/prompts-media adresine göz atın.
JSON gösterimi | |
---|---|
{ "mediaType": enum ( |
Alanlar | |
---|---|
mediaType |
|
startOffset |
İlk medya nesnesinin başlangıç ofseti. En fazla dokuz kesirli basamağa sahip, " |
optionalMediaControls[] |
Bu medya yanıtı oturumunun destekleyebileceği isteğe bağlı medya kontrolü türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3. tarafa istek gönderilir. Ayarlanmazsa 3p yine de TAMAMLANDI ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir. |
mediaObjects[] |
Medya Nesneleri Listesi |
repeatMode |
Medya Nesneleri listesi için tekrar modu. |
firstMediaObjectIndex |
mediaObjects içindeki ilk Medya Nesnesi'nin 0 tabanlı dizini. Belirtilmemişse, sıfır veya sınırların dışındaysa oynatma, mediaObjects içindeki ilk medya nesnesinde başlar. |
MediaType
Bu yanıtın medya türü.
Sıralamalar | |
---|---|
MEDIA_TYPE_UNSPECIFIED |
|
AUDIO |
Ses dosyası. |
MEDIA_STATUS_ACK |
Medya durum raporunu onaylama yanıtı. |
OptionalMediaControls
Medya yanıtının destekleyebileceği isteğe bağlı medya kontrolü türleri
Sıralamalar | |
---|---|
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED |
Belirtilmemiş değer |
PAUSED |
Etkinlik duraklatıldı. Kullanıcı medyayı duraklattığında tetiklenir. |
STOPPED |
Etkinlik durduruldu. Kullanıcı medya oynatma sırasında 3. oturumdan çıktığında tetiklenir. |
MediaObject
Tek bir medya nesnesini temsil eder
JSON gösterimi | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Bu medya nesnesinin adı. |
description |
Bu medya nesnesinin açıklaması. |
url |
Medya içeriğini gösteren URL. MP3 dosyaları bir web sunucusunda barındırılmalı ve HTTPS URL'si aracılığıyla herkese açık olmalıdır. Canlı yayın yalnızca MP3 biçiminde desteklenir. |
image |
Medya kartıyla gösterilecek resim. |
MediaImage
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birleştirme alanı
|
||
large |
Albümün kapağı gibi büyük bir resim. |
|
icon |
Başlığın sağında küçük bir resim simgesi görüntülenir. 36x36 dp olarak yeniden boyutlandırıldı. |
RepeatMode
Medya nesnelerinin listesi için tekrar modu türleri.
Sıralamalar | |
---|---|
REPEAT_MODE_UNSPECIFIED |
KAPALI durumuna eşdeğerdir. |
OFF |
Son medya nesnesinin sonunda medya oturumunu sonlandırın. |
ALL |
Son medya nesnesinin sonuna ulaşıldığında ilk medya nesnesinin başına döngü oluştur. |
Koleksiyon
Aralarından seçim yapabileceğiniz bir dizi seçenek sunan bir kart. https://developers.google.com/assistant/conversational/prompts-selection#collection adresine göz atın.
JSON gösterimi | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Alanlar | |
---|---|
title |
Koleksiyonun başlığı. İsteğe bağlı. |
subtitle |
Koleksiyonun alt başlığı. İsteğe bağlı. |
items[] |
Öğe listesi. Değer en az 2, en fazla 10 olabilir. |
imageFill |
Koleksiyon öğelerinin resim arka planlarının nasıl doldurulacağı. İsteğe bağlı. |
CollectionItem
Koleksiyondaki bir öğe
JSON gösterimi | |
---|---|
{ "key": string } |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı. |
Liste
Seçebileceğiniz seçeneklerin listesini sunan bir kart. https://developers.google.com/assistant/conversational/prompts-selection#list adresine göz atın.
JSON gösterimi | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Alanlar | |
---|---|
title |
Listenin başlığı. İsteğe bağlı. |
subtitle |
Listenin alt başlığı. İsteğe bağlı. |
items[] |
Öğe listesi. Değer en az 2, en fazla 30 olabilir. |
ListItem
Listedeki bir öğe
JSON gösterimi | |
---|---|
{ "key": string } |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı. |
CollectionBrowse
Bir dizi web dokümanını, büyük parçalı öğelerin koleksiyonu olarak sunar. İlişkili web dokümanlarını bir web görüntüleyicide başlatmak için öğeler seçilebilir. https://developers.google.com/assistant/conversational/prompts-selection#collectionBrowse adresine göz atın.
JSON gösterimi | |
---|---|
{ "items": [ { object ( |
Alanlar | |
---|---|
items[] |
Öğe listesi. Değer en az 2, en fazla 10 olabilir. |
imageFill |
Resim görüntüleme seçeneğinin türü. |
Öğe
Koleksiyondaki öğe.
JSON gösterimi | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
Alanlar | |
---|---|
title |
Zorunlu. Koleksiyon öğesinin başlığı. |
description |
Koleksiyon öğesinin açıklaması. |
footer |
Koleksiyon öğesi için açıklamanın altında görüntülenen altbilgi metni. Üç nokta ile kısaltılmış tek satır metin. |
image |
Koleksiyon öğesinin resmi. |
openUriAction |
Zorunlu. Öğe seçildiyse açılacak URI. |
Öneri
Asistan istemi gösterdiğinde öneriler, görüntüleme özellikli cihazlardaki kullanıcılara öneri çipleri sunar. Sohbeti devam ettirmek veya özetlemek için kullanıcı yanıtlarıyla ilgili ipucu vermek amacıyla öneri çiplerini kullanın. Öneri çipine dokunulduğunda, gösterilen metin, kullanıcı yazmış gibi görüşmeye tam olarak geri döner. https://developers.google.com/assistant/conversational/prompts#suggestions adresine göz atın.
JSON gösterimi | |
---|---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. Öneri çipinde gösterilen metin. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öneri çipi grubu içinde benzersiz olmalıdır. Maksimum 25 karakter |
Tuval
Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, "firstSimple" ile birlikte kullanılabilir. alanına girin. Yanıtın maksimum boyutu 50 bin bayttır. https://developers.google.com/assistant/interactivecanvas adresini ziyaret edin.
JSON gösterimi | |
---|---|
{
"url": string,
"data": [
value
],
"suppressMic": boolean,
"continuousMatchConfig": {
object ( |
Alanlar | |
---|---|
url |
Yüklenecek etkileşimli kanvas web uygulamasının URL'si. Ayarlanmazsa mevcut etkin tuvaldeki URL yeniden kullanılır. |
data[] |
İsteğe bağlı. Tam sayfa deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. "Geçersiz kıl" içeren istemdeki alanın "false" olması Bu Canvas isteminde tanımlanan veri değerleri, önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenecek. |
suppressMic |
İsteğe bağlı. Varsayılan değer: false. |
continuousMatchConfig |
Sürekli eşleme modunu başlatmak için kullanılan yapılandırma. |
ContinuousMatchConfig
Sürekli eşleme modunu başlatmak için kullanılan yapılandırma.
JSON gösterimi | |
---|---|
{
"expectedPhrases": [
{
object ( |
Alanlar | |
---|---|
expectedPhrases[] |
Bu sürekli eşleme modu oturumu sırasında olası tüm olası ifadeler. |
durationSeconds |
Sürekli eşleme modunun açık tutulacağı süre. Belirtilirse süre dolduğunda mikrofon kapatılır. İzin verilen maksimum değer 180'dir. |
ExpectedPhrase
JSON gösterimi | |
---|---|
{ "phrase": string, "alternativePhrases": [ string ] } |
Alanlar | |
---|---|
phrase |
Sürekli eşleme modu oturumu sırasında eşleştirilecek ifade. |
alternativePhrases[] |
Bazı ifadeler, konuşmaya ağırlık vermede bile konuşma modeli tarafından yanlış algılanabilir. Bu, geliştiricilerin homofonlar için alternatif tetikleyiciler belirtmesine olanak tanır. |
OrderUpdate
Bir siparişle güncelleyin.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. = SNAPSHOT türündeyse, OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise bu, sipariş düzeyinde durum değişikliğidir. Yalnızca Order.last_update_time ve bu sektör/tema durumu alınır. Not: type.ORDER_STATUS, yalnızca Purcahase OrderExtension durum güncellemelerini destekler ve bu desteğin genişletilmesiyle ilgili bir plan yoktur. Bunun yerine, daha genel, genişletilebilir ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz. |
order |
|
updateMask |
Not: Aşağıdaki özel alanlar için şu hususlar/öneriler geçerlidir: 1. order.last_update_time güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. order.create_time, order.google_order_id ve order.merchant_order_id gibi değerleri, updateMask kapsamında sağlanırsa yoksayılır. Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: |
userNotification |
Belirtilirse kullanıcıya, belirtilen başlık ve metinle bir bildirim görüntüler. Bir bildirimin belirtilmesi, bildirimde bulunulması önerilir ve bildirimle sonuçlanacağı garanti edilmez. |
reason |
Değişikliğin/güncellemenin nedeni. |
Tür
Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. Bir siparişte izin verilen güncellemeler.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi, bunu açık bir şekilde ayarlamamalıdır. |
ORDER_STATUS |
Yalnızca siparişin durumunu günceller. |
SNAPSHOT |
Sipariş anlık görüntüsünü güncelleyin. |
Sipariş
Sipariş varlığı. Not: 1. Aksi belirtilmedikçe tüm düzeylerdeki tüm dizeler 1.000 karakterden kısa olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerdeki yinelenen tüm alanların sayısı 50'den az olmalıdır. 3. Belirtilmişse tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.
JSON gösterimi | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Alanlar | ||
---|---|---|
googleOrderId |
Google tarafından atanan sipariş kimliği. |
|
merchantOrderId |
Zorunlu: Satıcı tarafından atanan dahili sipariş kimliği. Bu kimlik benzersiz olmalıdır ve sonraki sipariş güncelleme işlemleri için gereklidir. Bu kimlik, sağlanan googleOrdersId veya başka bir benzersiz değere ayarlanabilir. Kullanıcılara sunulan kimlik, farklı ve daha kullanıcı dostu bir değer olan uservisible OrderId olabilir. İzin verilen maksimum uzunluk 128 karakterdir. |
|
userVisibleOrderId |
Geçerli siparişe referans veren kullanıcıya yönelik kimlik. Bu kimlik; web siteleri, uygulamalar ve e-posta dahil diğer bağlamlarda bu sipariş için görüntülenen kimlikle tutarlı olmalıdır. |
|
userVisibleStateLabel |
Desteği sonlandırıldı: Bunun yerine OrderExtensions durumunu kullanın. Bu siparişin durumu için kullanıcı tarafından görülebilen etiket. |
|
buyerInfo |
Alıcıyla ilgili bilgiler. |
|
image |
Siparişle ilişkilendirilen resim. |
|
createTime |
Gerekli: Siparişin oluşturulduğu tarih ve saat. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
|
lastUpdateTime |
Siparişin son güncellendiği tarih ve saat. OrderUpdate için gereklidir. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
|
transactionMerchant |
Ödeme işlemini kolaylaştıran satıcı. Bu, satır öğesi seviyesindeki bir sağlayıcıdan farklı olabilir. Örnek: ANA'dan satır öğesi içeren Expedia Siparişi. |
|
contents |
Gerekli: Bir satır öğesi grubu olan sipariş içerikleri. |
|
priceAttributes[] |
Fiyat, indirimler, vergiler vb. |
|
followUpActions[] |
Sipariş düzeyinde takip işlemleri. |
|
paymentData |
Siparişe ilişkin ödemeyle ilgili veriler. |
|
termsOfServiceUrl |
Sipariş/önerilen sipariş için geçerli olan hizmet şartlarının bağlantısı. |
|
note |
Bir siparişe notlar eklendi. |
|
promotions[] |
Bu siparişle ilişkili tüm promosyonlar. |
|
disclosures[] |
Bu siparişle ilgili açıklamalar. |
|
vertical |
Desteği sonlandırıldı: Bunun yerine sektörleri kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör türüyle eşleşmelidir. Muhtemel değerler: Rastgele türden alanlar içeren nesne. Ek bir |
|
Birleştirme alanı verticals . Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör türüyle eşleşmelidir. verticals şunlardan yalnızca biri olabilir: |
||
purchase |
Satın alma siparişi |
|
ticket |
Bilet siparişi |
UserInfo
Kullanıcı hakkında bilgiler. Bu, bir siparişle ilişkili kullanıcıya ait bilgileri göstermek için kullanılır.
JSON gösterimi | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
Alanlar | |
---|---|
email |
Kullanıcı e-posta adresi (ör. janedoe@gmail.com). |
firstName |
Kullanıcının adı. |
lastName |
Kullanıcının soyadı. |
displayName |
Kullanıcının görünen adı, ad veya soyadından farklı olabilir. |
phoneNumbers[] |
Kullanıcının telefon numaraları. |
Telefon Numarası
Standart telefon numarası temsili.
JSON gösterimi | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
Alanlar | |
---|---|
e164PhoneNumber |
Uluslararası Telekomünikasyon Birliği'nin (ITU) E.164 Önerisinde tanımlandığı şekilde E.164 biçiminde telefon numarası. wiki bağlantısı: https://en.wikipedia.org/wiki/E.164 |
extension |
Maksimum 40 haneli bir sayı dizisi olarak tanımlananlar haricinde, ITU önerilerinde uzantı standartlaştırılmamıştır. Burada, uzantıda baştaki sıfırın olası kullanımına yer vermek için kullanılacak bir dize olarak tanımlanır (herhangi bir standart tanımlanmış olmadığından kuruluşlar bunu yapma konusunda tam özgürlüğe sahiptir). Rakamlar dışında, "," gibi diğer bazı karakterleri (beklemeyi belirten) burada saklanabilir. Örneğin, xxx-xxx-xxxx ext. 123, "123" uzantı. |
preferredDomesticCarrierCode |
Bu telefon numarası yurt içinde aranırken tercih edilen operatör seçim kodu. Buna, bazı ülkelerde sabit hatlardan cep telefonuna veya tam tersi hatlardan arama yaparken aranması gereken kodlar da dahildir. Örneğin, Columbia'da "3" bir cep telefonundan yerel bir sabit hat numarasına arama yaparken (veya tam tersi) telefon numarasından önce aranması gerekir. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code Bunun "tercih edilen" olduğunu unutmayın diğer kodların da çalışabileceği anlamına gelir. |
Resim
Kartta bir resim gösteriliyor.
JSON gösterimi | |
---|---|
{ "url": string, "accessibilityText": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Resmin kaynak URL'si. Resimler JPG, PNG ve GIF biçiminde (animasyonlu veya animasyonsuz) olabilir. Örneğin, |
accessibilityText |
Erişilebilirlik için kullanılacak resmin metin açıklaması, ör. Ekran okuyucular. Zorunlu. |
height |
Resmin piksel cinsinden yüksekliği. İsteğe bağlı. |
width |
Resmin piksel cinsinden genişliği. İsteğe bağlı. |
Satıcı
Alışveriş sepeti/sipariş/satır öğesinin satıcısı.
JSON gösterimi | |
---|---|
{ "id": string, "name": string, "image": { object ( |
Alanlar | |
---|---|
id |
Varsa satıcıya atanan isteğe bağlı kimlik. |
name |
Satıcının adı (ör. "Panera Ekmek") |
image |
Satıcıyla ilişkili resim. |
phoneNumbers[] |
Satıcının telefon numaraları. |
address |
Satıcının adresi. |
Konum
Bir konumu temsil eden kapsayıcı.
JSON gösterimi | |
---|---|
{ "coordinates": { object ( |
Alanlar | |
---|---|
coordinates |
Coğrafi koordinatlar. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni. |
formattedAddress |
Görünen adres, ör. "Basın Sitesi Mahallesi, 215 Sokak, Karabağlar, İzmir 35150". [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni. |
zipCode |
Posta kodu. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni. |
city |
Şehir. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni. |
postalAddress |
Posta adresi. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni. |
name |
Yerin adı. |
phoneNumber |
Konumun telefon numarası, ör. işletme konumunun iletişim numarası veya teslimat yeri için telefon numarası. |
notes |
Konumla ilgili notlar. |
placeId |
PlaceId, bir yerin ayrıntılarını getirmek için Places API ile kullanılır. https://developers.google.com/places/web-service/place-id adresini ziyaret edin |
LatLng
Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.
JSON gösterimi | |
---|---|
{ "latitude": number, "longitude": number } |
Alanlar | |
---|---|
latitude |
Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır. |
longitude |
Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır. |
PostalAddress
Bir posta adresini temsil eder, ör. veya ödeme adresleri için de geçerlidir. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.
Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.
Adres girişi / düzenleme ile ilgili öneri: - https://github.com/google/libaddressinput gibi i18n özellikli bir adres widget'ı kullanın) - Kullanıcılara, alanın kullanıldığı ülkeler dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağıyla ilgili daha fazla yardım için lütfen bkz: https://support.google.com/business/answer/6397478
JSON gösterimi | |
---|---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Alanlar | |
---|---|
revision |
Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek kullanıcıya bağlıdır. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: "CH" kullanmaya başladım. |
languageCode |
İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu genellikle giriş formunun kullanıcı arayüzü dilidir veya adreste kullanılan dillerden biriyle eşleşmesi beklenir ülke/bölge ya da harf çevirisi yapılmış eşdeğerleri. Bu, belirli ülkelerde biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir. |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili). |
administrativeArea |
İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin, bu bir eyalet, il, oblast veya vilayet olabilir. Özellikle, İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmadan bırakılmalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada konumların iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, yerel ayarı boş bırakın ve addressLines kullanın. |
sublocality |
İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir. |
addressLines[] |
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines'taki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebildiğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası "zarf sırası" olmalıdır girin. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" ya da "en"). Bu şekilde, bir adresin en spesifik satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode'dan oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar hiçbir adres bileşeni hakkında anlamsal çıkarımda bulunulamaz. Yalnızca regionCode ve addressLines içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri işlemek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine). |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, ekleyebilirsiniz. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |
İçindekiler
Satır öğeleri için sarmalayıcı.
JSON gösterimi | |
---|---|
{
"lineItems": [
{
object ( |
Alanlar | |
---|---|
lineItems[] |
Sipariş satır öğelerinin listesi. En az 1 satır öğesi gereklidir ve en fazla 50 satır öğesine izin verilir. Tüm satır öğeleri aynı sektöre ait olmalıdır. |
LineItem
Bir satır öğesi bir sektör içeriyor. Bir siparişte veya alışveriş sepetinde aynı sektörde birden fazla satır öğesi bulunabilir. Alt satır öğeleri/eklentiler vb., kullanım alanlarına bağlı olarak dikey protolarda tanımlanmalıdır. Not: 1. Aksi belirtilmedikçe tüm düzeylerdeki tüm dizeler 1.000 karakterden kısa olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerdeki yinelenen tüm alanların sayısı 50'den az olmalıdır. 3. Belirtilmişse tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.
JSON gösterimi | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
Alanlar | ||
---|---|---|
id |
Gerekli: Satır öğesi için satıcı tarafından atanan tanımlayıcı. Kısmi güncellemeleri uygularken mevcut satır öğesini tanımlamak için kullanılır. İzin verilen maksimum uzunluk 64 karakterdir. |
|
name |
Makbuzda görünen satır öğesinin adı. İzin verilen maksimum uzunluk 100 karakterdir. |
|
userVisibleStateLabel |
Kullanımdan kaldırıldı. Bunun yerine dikey düzey durumunu kullanın. Örneğin, satın alma işlemleri için Purchase OrderExtension.status ifadesini kullanın. Bu satır öğesinin durumu için kullanıcı tarafından görülebilen etiket. |
|
provider |
Belirli bir satır öğesinin sağlayıcısı (genel siparişten farklıysa). Örnek: Satır öğesi sağlayıcısı ANA'yı içeren Expedia Siparişi. |
|
priceAttributes[] |
Satır öğesi seviyesinde fiyat ve düzenlemeler. |
|
followUpActions[] |
Satır öğesinde takip işlemleri. |
|
recipients[] |
Satır öğesi düzeyindeki müşteriler. Bu, Sipariş düzeyinde alıcıdan farklı olabilir. Örnek: X kullanıcısı, Y kullanıcısı adına restoran rezervasyonu yapmıştır. |
|
image |
Bu öğeyle ilişkili küçük resim (varsa). |
|
description |
Satır öğesi açıklaması. |
|
notes[] |
Bu satır öğesi için geçerli olan ek notlar (ör. iptal politikası). |
|
disclosures[] |
Bu satır öğesiyle ilişkili açıklamalar. |
|
vertical |
Desteği sonlandırıldı: Bunun yerine sektörleri kullanın. Gerekli: Türüne/sektörüne göre satır öğesinin Semantik İçeriği. Her sektör, kendi sipariş karşılama ayrıntılarını içermelidir. Şu değerlerden biri olmalıdır: Rastgele türden alanlar içeren nesne. Ek bir |
|
Birleştirme alanı verticals . Gerekli: Türüne/sektörüne göre satır öğesinin Semantik İçeriği. Her sektör, kendi sipariş karşılama ayrıntılarını içermelidir. verticals şunlardan yalnızca biri olabilir: |
||
purchase |
Mal, yiyecek vb. satın alma siparişleri |
|
reservation |
Restoran, saç kesimi vb. rezervasyon siparişleri |
PriceAttribute
Bir siparişin veya satır öğesinin fiyat özelliği.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | ||
---|---|---|
type |
Zorunlu: Para özelliğinin türü. |
|
name |
Zorunlu: Fiyat özelliğinin kullanıcı tarafından gösterilen dizesi. Bu bilgi satıcı tarafından gönderilir ve yerelleştirilir. |
|
id |
İsteğe bağlı: Bu fiyatın karşılık geldiği satır öğesinin kimliği. |
|
state |
Gerekli: Fiyatın durumu: Tahmini ve Gerçekleşen. |
|
taxIncluded |
Fiyata vergi dahil olup olmadığı. |
|
Birleştirme alanı spec . Parasal tutarı veya milisaniye cinsinden yüzdeyi temsil eder. spec şunlardan yalnızca biri olabilir: |
||
amount |
Para tutarı. |
|
amountMillipercentage |
Yüzdenin 1/1000'i oranında yüzde spesifikasyonu. Ör. %8, 750 8750 olarak temsil edilir; negatif yüzdeler ise yüzdelik indirimleri temsil eder. Bu alan kullanımdan kaldırılıyor. Sağlam bir kullanım alanı gerektiğinde tekrar eklemeyi düşünebilirsiniz. |
Tür
Para türünü gösterir.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi. İstemcilerin bunu açık bir şekilde ayarlaması gerekmez. |
REGULAR |
Herhangi bir indirim vb. uygulanmadan önceki normal görünen fiyat. |
DISCOUNT |
Ara toplamdan çıkarılacak. |
TAX |
Ara toplama eklenecek. |
DELIVERY |
Ara toplama eklenecek. |
SUBTOTAL |
Bazı ücretler eklenmeden önceki ara toplam. |
FEE |
Ek Ücretler. |
GRATUITY |
Ara toplama eklenecek. |
TOTAL |
Siparişin veya satır öğesinin gösterilen fiyatı. |
Eyalet
Fiyat durumunu gösterir.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmedi. |
ESTIMATE |
Fiyat yalnızca tahmini bir değerdir ancak nihai tutar bu tutara yakındır. Örnek: İşlem sırasında verginin doğru bir şekilde bilinmediği durumlarda toplam tutar ESTIMATE olur. |
ACTUAL |
Kullanıcı için alınacak gerçek fiyat. |
Para
Para birimi türüyle birlikte bir para tutarını gösterir.
JSON gösterimi | |
---|---|
{ "currencyCode": string, "amountInMicros": string } |
Alanlar | |
---|---|
currencyCode |
ISO 4217'de tanımlanan 3 harfli para birimi kodu. |
amountInMicros |
Mikro cinsinden miktar. Örneğin, bu alan 1,99 ABD doları için 1990000 olarak ayarlanmalıdır. |
İşlem
Sipariş veya satır öğesiyle ilişkili takip işlemi.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Zorunlu: İşlem türü |
title |
İşlemin kullanıcıya gösterilen başlığı veya etiketi. İzin verilen maksimum uzunluk 100 karakterdir. |
openUrlAction |
Yapılacak işlem. |
actionMetadata |
Bir işlemle ilişkili meta veriler. |
Tür
Olası takip işlemleri.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Belirtilmemiş işlem. |
VIEW_DETAILS |
Sipariş ayrıntılarını görüntüle işlemi. |
MODIFY |
Sipariş işlemini değiştirme işlemi. |
CANCEL |
Siparişi iptal etme işlemi. |
RETURN |
Sipariş iadesi işlemi. |
EXCHANGE |
Exchange sipariş işlemi. |
EMAIL |
E-posta işlemi. EMAIL ve CALL türleri kullanımdan kaldırıldı. openUrlAction.url, telefon numarası veya e-posta olarak kullanılabilir. |
CALL |
Arama işlemi. |
REORDER |
İşlemi yeniden sıralayın. |
REVIEW |
Sipariş işlemini inceleyin. |
CUSTOMER_SERVICE |
Müşteri hizmetleriyle iletişime geçin. |
FIX_ISSUE |
Sorunu düzeltmek için satıcı sitesine veya uygulamasına yönlendirin. |
DIRECTION |
Yol tarifi bağlantısı. |
OpenUrlAction
Belirtilen URL'yi açar.
JSON gösterimi | |
---|---|
{ "url": string, "androidApp": { object ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls |
androidApp |
URL'nin bir Android uygulaması tarafından yerine getirilmesi bekleniyorsa Android Uygulaması hakkında bilgiler. |
urlTypeHint |
URL türüyle ilgili bir ipucu gösterir. |
AndroidApp
Sipariş karşılama kısıtlamalarıyla ilgili Android uygulaması spesifikasyonu
JSON gösterimi | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
Alanlar | |
---|---|
packageName |
Paket adı Android Sipariş Karşılaması belirtilirken Paket adı belirtilmelidir. |
versions[] |
Birden fazla filtre belirtildiğinde, herhangi bir filtre eşleşmesi uygulamayı tetikler. |
VersionFilter
Uygulamanın belirli sürümleri gerekiyorsa VersionFilter eklenmelidir.
JSON gösterimi | |
---|---|
{ "minVersion": integer, "maxVersion": integer } |
Alanlar | |
---|---|
minVersion |
Minimum sürüm kodu veya 0 (bu değerler dahil). |
maxVersion |
Maksimum sürüm kodu (bu değerler dahil). Dikkate alınan aralık: [minVersion:maxVersion]. Boş aralık, herhangi bir sürümü belirtir. Örnekler: Tek bir sürüm belirtmek için şunu kullanın: [target_version:target_version]. Herhangi bir sürümü belirtmek için minVersion ve maxVersion belirtilerini belirtmeden bırakın. maxVersion tarihine kadar tüm sürümleri belirtmek için minVersion değerini belirtmeden bırakın. minVersion sürümündeki tüm sürümleri belirtmek için maxVersion değerini belirtmeden bırakın. |
UrlTypeHint
Farklı URL ipuçları türleri.
Sıralamalar | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
Belirtilmedi |
AMP_CONTENT |
Doğrudan AMP içeriğine veya <link rel="amphtml"> aracılığıyla AMP içeriğine başvuruda bulunan standart URL'ye yönlendiren URL. |
ActionMetadata
İşlem başına ilgili meta veri.
JSON gösterimi | |
---|---|
{ "expireTime": string } |
Alanlar | |
---|---|
expireTime |
Bu işlemin süresinin dolacağı zaman. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
Açıklama
Kullanıcıya sunulabilecek ürün, hizmet veya politika açıklaması.
JSON gösterimi | |
---|---|
{ "title": string, "disclosureText": { object ( |
Alanlar | |
---|---|
title |
Açıklamanın başlığı. Örnek: "Güvenlik bilgileri". |
disclosureText |
Açıklamanın içeriği. Web bağlantılarına izin veriliyor. |
presentationOptions |
Açıklama için sunum seçenekleri. |
DisclosureText
Web bağlantıları içeren düz bir metni temsil eder.
JSON gösterimi | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
Alanlar | |
---|---|
template |
"{0}" gibi yer tutucular içeren, görüntülenecek metin ve "{1}" eklemeniz gerekir. Örnek: "UYARI: Bu ürün sizi kansere neden olduğu Kaliforniya Eyaleti tarafından bilinen kimyasallara maruz bırakabilir. Daha fazla bilgi için {0}" bölümüne gidin. Bu açıklama metni, tanıtım amaçlı veya reklam benzeri herhangi bir içerik barındırmamalıdır. |
textLinks[] |
Şablonda değiştirilmesi gereken metin bağlantıları. İlki, "{0}" ile değiştirilecek kullanabilirsiniz. İkincisi, "{1}" vb. için |
TextLink
Şablonun yerini alması gereken bir metin bağlantısı.
JSON gösterimi | |
---|---|
{ "displayText": string, "url": string } |
Alanlar | |
---|---|
displayText |
Kullanıcılara gösterilmesi gereken metin. |
url |
Bağlantı etkinleştirildiğinde kullanıcıların yönlendirilmesi gereken URL. |
DisclosurePresentationOptions
Açıklama sunma seçenekleri.
JSON gösterimi | |
---|---|
{
"presentationRequirement": enum ( |
Alanlar | |
---|---|
presentationRequirement |
Açıklamanın sunum şartı. |
initiallyExpanded |
Açıklama içeriğinin başlangıçta genişletilip genişletilmeyeceğini belirler. Varsayılan olarak, başlangıçta daraltılmış durumdadır. |
PresentationRequirement
Açıklamanın sunulması için şartlar.
Sıralamalar | |
---|---|
REQUIREMENT_UNSPECIFIED |
Koşul belirtilmedi. Bu ayar açık bir şekilde yapılmamalıdır. |
REQUIREMENT_OPTIONAL |
Açıklama isteğe bağlıdır. Cihaz, açıklamaları göstermeyi desteklemiyorsa bu adım atlanabilir. |
REQUIREMENT_REQUIRED |
Açıklama zorunludur. Cihaz, açıklamaları göstermeyi desteklemiyorsa görüşme telefona yönlendirilir. |
PurchaseItemExtension
Satın Alma Sektörünün satır öğesi içeriği.
JSON gösterimi | |
---|---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Gerekli: Satır öğesi düzeyi durumu. |
userVisibleStatusLabel |
Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir. |
type |
Zorunlu: Satın alma türü. |
productId |
Bu satır öğesiyle ilişkili ürün veya teklif kimliği. |
quantity |
Öğenin miktarı. |
unitMeasure |
Birim ölçüsü. Seçilen birimlerdeki öğenin boyutunu belirtir. Boyut, etkin fiyatla birlikte birim fiyatı belirlemek için kullanılır. |
returnsInfo |
Bu satır öğesinin bilgilerini döndürür. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyinde döndürme bilgilerini devralır. |
fulfillmentInfo |
Bu satır öğesinin sipariş karşılama bilgileri. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyinde sipariş karşılama bilgilerini devralır. |
itemOptions[] |
Ek eklentiler veya alt öğeler. |
productDetails |
Ürünle ilgili ayrıntılar. |
extension |
Satıcı ile Google arasında aktarılan tüm ek alanlar. Not: Bu uzantının kullanılması hiçbir şekilde önerilmez. Kullanım alanına/duruma bağlı olarak aşağıdakilerden birini düşünün: 1. Diğer kullanım alanları (ör. genel özellik/işlev) için kullanılabilecekse PurchaseItemExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension değerini kullanın. Rastgele türden alanlar içeren nesne. Ek bir |
PurchaseStatus
Bir satın alma siparişiyle veya belirli bir satır öğesiyle ilişkili satın alma durumu.
Sıralamalar | |
---|---|
PURCHASE_STATUS_UNSPECIFIED |
Durum belirtilmedi. |
READY_FOR_PICKUP |
Teslim alma için hazır. |
SHIPPED |
Gönderildi. |
DELIVERED |
Teslim edildi. |
OUT_OF_STOCK |
Stokta yok. |
IN_PREPARATION |
"IN_PREPARATION" farklı bağlamda farklı anlamlar taşıyabilir. YİYECEK siparişi için, yemek hazırlanıyor olabilir. Perakende satış açısından ise bir öğe paketleniyor olabilir. |
CREATED |
Sipariş oluşturuldu. |
CONFIRMED |
Satıcı siparişi onayladı. |
REJECTED |
Satıcı siparişi veya satır öğesini reddetti. |
RETURNED |
Öğe, kullanıcı tarafından iade edildi. |
CANCELLED |
Sipariş veya satır öğesi kullanıcı tarafından iptal edildi. |
CHANGE_REQUESTED |
Kullanıcı siparişte bir değişiklik isteğinde bulundu ve entegrasyon uzmanı bu değişikliği işliyor. İstek işlendikten sonra siparişin başka bir duruma taşınması gerekir. |
PurchaseType
Satın alma kategorisi.
Sıralamalar | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
Bilinmeyen değer. |
RETAIL |
Fiziksel ürünler gibi satın alma işlemlerini içerir. |
FOOD |
Buna yemek siparişi satın alma da dahildir. |
GROCERY |
Market alışverişi. |
MOBILE_RECHARGE |
Ön ödemeli mobil para yükleme satın alma işlemi. |
MerchantUnitMeasure
Satıcının birim fiyatlandırma ölçüsü.
JSON gösterimi | |
---|---|
{
"measure": number,
"unit": enum ( |
Alanlar | |
---|---|
measure |
Değer: Örnek 1.2. |
unit |
Birim: Örnek POUND, GRAM. |
Birim
Sıralamalar | |
---|---|
UNIT_UNSPECIFIED |
Birim belirtilmedi. |
MILLIGRAM |
Miligram. |
GRAM |
Gram. |
KILOGRAM |
Kilogram. |
OUNCE |
Ons. |
POUND |
Sterlin. |
PurchaseReturnsInfo
Bir sipariş veya belirli bir satır öğesiyle ilişkili bilgileri döndürür.
JSON gösterimi | |
---|---|
{ "isReturnable": boolean, "daysToReturn": integer, "policyUrl": string } |
Alanlar | |
---|---|
isReturnable |
True (doğru) ise, döndürmeye izin verilir. |
daysToReturn |
Bu sayıda gün içinde iade yapılabilir. |
policyUrl |
İade politikasının bağlantısı. |
PurchaseFulfillmentInfo
Bir satın alma siparişi veya belirli bir satır öğesiyle ilişkili sipariş karşılama bilgileri.
JSON gösterimi | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
Alanlar | |
---|---|
id |
Bu hizmet seçeneğinin benzersiz tanımlayıcısı. |
fulfillmentType |
Zorunlu: İstek karşılama türü. |
expectedFulfillmentTime |
Bir zaman aralığı belirtilmişse bir pencere, tek bir zaman belirtilmişse TVS. Beklenen teslimat veya teslim alma zamanı. |
expectedPreparationTime |
Bir zaman aralığı belirtilmişse bir pencere, tek bir zaman belirtilmişse TVS. Yemeği hazırlaması için beklenen süre. Tek seferlik tercih edilir. |
location |
Teslim alma veya teslimat konumu. |
expireTime |
Bu sipariş karşılama seçeneğinin süresinin dolacağı zaman. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
price |
Bu seçeneğin maliyeti. |
fulfillmentContact |
Bu sipariş karşılamayla ilgili kullanıcı iletişim bilgileri. |
shippingMethodName |
Kullanıcı tarafından seçilen gönderim yönteminin adı. |
storeCode |
Konumun mağaza kodu. Örnek: Walmart satıcıyı, storeCode ise sipariş karşılamanın gerçekleştiği Walmart mağazasıdır. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
Siparişin nasıl seçileceğiyle ilgili ek bilgi. Bu alan yalnızca sipariş karşılama türü TESLİM ALIN ise kullanılabilir. |
Tür
Sipariş karşılama türü.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi. |
DELIVERY |
Bu sipariş teslim edilecek. |
PICKUP |
Bu siparişin teslim alınması gerekiyor. |
Saat
Kullanıcıya sipariş gösterilirken kullanılacak etkinliğin zamanını temsil eden zaman yapısı.
JSON gösterimi | |
---|---|
{ "timeIso8601": string } |
Alanlar | |
---|---|
timeIso8601 |
Rezervasyon saati, teslimat zamanı vb. bir sipariş etkinliği zamanını gösterir. Bir süre (başlangıç ve bitiş saati), yalnızca tarih, tarih ve saat gibi bir bilgi olabilir. Desteklenen tüm biçimler için https://en.wikipedia.org/wiki/ISO_8601 sayfasına bakın. |
PickupInfo
Siparişin nasıl teslim alındığıyla ilgili ayrıntılar. Bu raporda, teslim alma türü ve varsa her türle ilişkili ek meta veriler gibi ayrıntılar yer alır.
JSON gösterimi | |
---|---|
{ "pickupType": enum ( |
Alanlar | |
---|---|
pickupType |
Teslim alma yöntemi (ör. INSTORE, CURBSIDE vb.) |
curbsideInfo |
Arabaya teslim alma bilgilerine özel ayrıntılar. pickupType "CURBSIDE" değilse bu alan yoksayılır. |
checkInInfo[] |
Check-in desteği sunmak için iş ortağı tarafından desteklenen çeşitli yöntemlerin listesi. |
PickupType
Desteklenen teslim alma türlerinin listesi.
Sıralamalar | |
---|---|
UNSPECIFIED |
Teslim alma türü belirtilmedi. |
INSTORE |
Yemekleri restoranın içinde almak. |
CURBSIDE |
Aracı restoranın dışında belirli bir yere park ederseniz bir kişi oraya yemek siparişi verecektir. |
CurbsideInfo
Arabaya teslim alma siparişinin nasıl kolaylaştırılacağıyla ilgili ayrıntılar.
JSON gösterimi | |
---|---|
{ "curbsideFulfillmentType": enum ( |
Alanlar | |
---|---|
curbsideFulfillmentType |
İş ortaklarının, arabaya teslim alma siparişlerini kolaylaştırmak için ek bilgiye ihtiyacı vardır. Seçilen sipariş karşılama türüne bağlı olarak ilgili ayrıntılar kullanıcıdan toplanır. |
userVehicle |
Sipariş veren kullanıcının araç bilgileri. |
CurbsideFulfillmentType
Arabaya teslim alma türlerinin olası değerleri.
Sıralamalar | |
---|---|
UNSPECIFIED |
Arabaya teslim alma türü belirtilmedi. |
VEHICLE_DETAIL |
Arabaya teslim almayı kolaylaştırmak için araç bilgileri gereklidir. |
Araç
Bir araçla ilgili ayrıntılar
JSON gösterimi | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
Alanlar | |
---|---|
make |
Araç markası (ör. "Honda"). Bu bilgi, kullanıcıya gösterilir ve yerelleştirilmesi gerekir. Zorunlu. |
model |
Araç modeli (ör. "Grom"). Bu bilgi, kullanıcıya gösterilir ve yerelleştirilmesi gerekir. Zorunlu. |
licensePlate |
Araç plaka numarası (ör. "1ABC234"). Zorunlu. |
colorName |
Araç rengi adı, ör. siyah İsteğe bağlı. |
image |
Araç fotoğrafının URL'si. Fotoğraf yaklaşık 256x256 piksel boyutunda görüntülenir. jpg veya png olmalıdır. İsteğe bağlı. |
CheckInInfo
Bir kontrol yöntemini desteklemek için iş ortağının ihtiyaç duyduğu meta veriler.
JSON gösterimi | |
---|---|
{
"checkInType": enum ( |
Alanlar | |
---|---|
checkInType |
Giriş talimatlarını göndermek için kullanılan yöntem. |
CheckInType
Giriş talimatlarını göndermek için kullanılan çeşitli yöntemler.
Sıralamalar | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
Bilinmeyen değer. |
EMAIL |
CheckIn bilgileri e-postayla gönderilir. |
SMS |
CheckIn bilgileri SMS ile gönderilir. |
ItemOption
Eklentileri veya alt öğeleri temsil eder.
JSON gösterimi | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
Alanlar | |
---|---|
id |
Öğe olan seçenekler için benzersiz öğe kimliği. |
name |
Seçenek adı. |
prices[] |
Seçenek toplam fiyatı. |
note |
Seçenekle ilgili not. |
quantity |
Öğe olan seçenekler için miktar. |
productId |
Bu seçenekle ilişkili ürün veya teklif kimliği. |
subOptions[] |
İç içe yerleştirilmiş diğer alt seçenekleri tanımlamak için kullanılır. |
ProductDetails
Ürünle ilgili ayrıntılar.
JSON gösterimi | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
Alanlar | |
---|---|
productId |
Bu satır öğesiyle ilişkili ürün veya teklif kimliği. |
gtin |
Ürünün Global Ticari Öğe Numarasıdır. OfferId değeri Merchant Center'da mevcut değilse kullanışlıdır. İsteğe bağlı. |
plu |
Genellikle PLU kodları, PLU numaraları, PLU'lar, ürün kodları veya ürün etiketleri olarak adlandırılan fiyat arama kodları, marketlerde ve süpermarketlerde satılan toplu ürünleri benzersiz şekilde tanımlayan bir sayı sistemidir. |
productType |
Satıcı tarafından tanımlanan ürün kategorisi. Ör. "Ana Sayfa > Market > Süt Ürünleri ve Yumurtalar > Süt > Tam Yağlı Süt" |
productAttributes |
Ürün hakkında satıcı tarafından sağlanan bilgiler (ör. { "allergen": "peanut" } tıklayın. OfferId değeri Merchant Center'da mevcut değilse kullanışlıdır. İsteğe bağlı.
|
ReservationItemExtension
Restoran, saç kesimi gibi rezervasyon siparişleri için satır öğesi içeriği.
JSON gösterimi | |
---|---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Zorunlu: Rezervasyon durumu. |
userVisibleStatusLabel |
Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir. |
type |
Rezervasyon türü. Tür seçeneklerinden hiçbiri geçerli değilse ayarlanmamış olabilir. |
reservationTime |
Hizmetin/etkinliğin planlandığı saat. Zaman aralığı, tarih veya kesin bir tarih saat olabilir. |
userAcceptableTimeRange |
Kullanıcı için kabul edilebilir zaman aralığı. |
confirmationCode |
Bu rezervasyon için onay kodu. |
partySize |
Kişi sayısı. |
staffFacilitators[] |
Rezervasyonla ilgilenecek olan personel moderatörleri. Ör. Kuaför. |
location |
Hizmetin/etkinliğin konumu. |
ReservationStatus
Rezervasyonun durumu.
Sıralamalar | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
Belirtilmemiş durum. |
PENDING |
Rezervasyon beklemede. |
CONFIRMED |
Rezervasyon onaylandı. |
CANCELLED |
Rezervasyon kullanıcı tarafından iptal edildi. |
FULFILLED |
Rezervasyon tamamlandı. |
CHANGE_REQUESTED |
Rezervasyon değişikliği istendi |
REJECTED |
Rezervasyonun süresi doldu veya entegratör tarafından reddedildi. |
ReservationType
Rezervasyon türü.
Sıralamalar | |
---|---|
RESERVATION_TYPE_UNSPECIFIED |
Tür belirtilmedi. |
RESTAURANT |
Restoran rezervasyonu. |
HAIRDRESSER |
Kuaför rezervasyonu. |
StaffFacilitator
Hizmet veren kişi hakkında bilgi.
JSON gösterimi | |
---|---|
{
"name": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Personel yöneticisinin adı. Ör. "Can Demir" |
image |
Sanatçının resimleri. |
PaymentData
Bir siparişle ilgili ödeme verileri.
JSON gösterimi | |
---|---|
{ "paymentResult": { object ( |
Alanlar | |
---|---|
paymentResult |
Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu. Ödeme deneyimi Actions-on-Google tarafından yönetiliyorsa bu alan Actions on Google tarafından doldurulur. |
paymentInfo |
Siparişle ilgili, kullanıcıların gördüğü etkileşimlerde faydalı olan ödeme bilgileri. |
PaymentResult
Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birleştirme alanı result . Google ödeme verileri veya satıcı ödeme yöntemi sağlanır. result şunlardan yalnızca biri olabilir: |
||
googlePaymentData |
Google tarafından sağlanan ödeme yöntemi verileri. Ödeme işleyiciniz şu adreste Google tarafından desteklenen ödeme işleyici olarak listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla bilgi edinmek için bağlantıyı kullanarak ödeme işleyicinize gidin. Aksi takdirde yük ayrıntıları için aşağıdaki belgelere bakın. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Kullanıcı tarafından seçilen satıcı/işlem tarafından sağlanan ödeme yöntemi. |
PaymentInfo
Verilen siparişle ilgili ödeme bilgileri. Bu protokol, kullanıcılara yönelik etkileşim için yararlı olan bilgileri yakalar.
JSON gösterimi | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Alanlar | |
---|---|
paymentMethodDisplayInfo |
İşlem için kullanılan ödeme yöntemiyle ilgili gösterilen bilgiler. |
paymentMethodProvenance |
İşlem için kullanılan ödeme yönteminin kaynağı. Kullanıcı, aynı ödeme yöntemini hem Google'da hem de satıcıda kaydetmiş olabilir. |
PaymentMethodDisplayInfo
Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu.
JSON gösterimi | |
---|---|
{
"paymentType": enum ( |
Alanlar | |
---|---|
paymentType |
Ödemenin türü. |
paymentMethodDisplayName |
Ödeme yönteminin kullanıcı tarafından görülebilen adı. Örneğin, VISA **** 1234 Çek hesabı **** 5678. |
paymentMethodVoiceName |
Yalnızca sesli asistan cihazları için kullanıcıya söylenecek ödeme yöntemi adı. Örneğin, "bir iki üç dört ile biten vize" veya "beş altı yedi sekiz ile biten çek hesabı". Not: Bu, yalnızca ses özellikli asistan cihazlarında paymentMethodDisplayName yerine kullanılacak sesle optimize edilmiş dizedir. Bu dize ayarlanmazsa ödemeMethodDisplayName kullanıcıya söylenir. |
PaymentType
PaymentType, satıcı tarafından sağlanan ödeme yöntemi için kullanılan ödeme şeklini gösterir. İşlem, ödeme yöntemi için bir görünen ad da sağlamalıdır.
Sıralamalar | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
Ödeme türü belirtilmedi. |
PAYMENT_CARD |
Kredi kartı/banka kartı veya ön ödemeli kart. |
BANK |
Ödeme yöntemi bir banka hesabıdır. |
LOYALTY_PROGRAM |
Ödeme yöntemi bir bağlılık programıdır. |
CASH |
Ödeme yöntemi nakit olarak yapılır. |
GIFT_CARD |
Ödeme yöntemi bir hediye kartıdır. |
WALLET |
Üçüncü taraf cüzdan (ör. PayPal) |
PaymentMethodProvenance
İşlem için kullanılan ödeme yöntemi kaynağını gösterir.
Sıralamalar | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
Kaynak Belirtilmemiş. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
Kaynak Google'dır. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
Köken Satıcıdır. |
Tanıtım
Alışveriş sepetine eklenen promosyonlar/teklifler.
JSON gösterimi | |
---|---|
{ "coupon": string } |
Alanlar | |
---|---|
coupon |
Gerekli: Bu teklife uygulanan kupon kodu. |
PurchaseOrderExtension
Satın alma sektörü için sipariş uzantısı. Bu özellikler, bir satır öğesinde geçersiz kılınmadıkça sipariş içindeki tüm satır öğeleri için geçerlidir.
JSON gösterimi | |
---|---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Gerekli: Sipariş için Genel Durum. |
userVisibleStatusLabel |
Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir. |
type |
Zorunlu: Satın alma türü. |
returnsInfo |
Siparişle ilgili iade bilgileri. |
fulfillmentInfo |
Siparişin sipariş karşılama bilgileri. |
purchaseLocationType |
Satın alma yeri (mağazada / internette) |
errors[] |
İsteğe bağlı: Bu siparişin reddedilmesine neden olan hatalar. |
extension |
Satıcı ile Google arasında aktarılan tüm ek alanlar. Not: Bu uzantının kullanılması hiçbir şekilde önerilmez. Kullanım alanına/duruma bağlı olarak aşağıdakilerden birini düşünün: 1. Diğer kullanım alanları (ör. genel özellik/işlev) için kullanılabilecekse Purchase OrderExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension değerini kullanın. Rastgele türden alanlar içeren nesne. Ek bir |
PurchaseLocationType
Satın alma işleminin bulunduğu konum türü.
Sıralamalar | |
---|---|
UNSPECIFIED_LOCATION |
Bilinmeyen değer. |
ONLINE_PURCHASE |
Tüm satın alma işlemleri çevrimiçi olarak satın alındı. |
INSTORE_PURCHASE |
Tüm mağaza içi satın alma işlemleri. |
PurchaseError
Satın alma siparişinin reddedilebileceği hatalar.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Gerekli: Bu, bir siparişin satıcı tarafından reddedilme nedenini ayrıntılı olarak gösterir. |
description |
Ek hata açıklaması. |
entityId |
Hataya karşılık gelen varlık kimliği. Örnek, bunun LineItemId / ItemOptionId öğesine karşılık gelebilir. |
updatedPrice |
PRICE_CHANGED / INCORRECT_PRICE hata türünde geçerlidir. |
availableQuantity |
Kullanılabilir miktar. AVAILABILITY_CHANGED durumunda geçerlidir. |
ErrorType
Olası hata türleri.
Sıralamalar | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Bilinmeyen hata |
NOT_FOUND |
Öğe bulunamadı. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği zorunludur. |
INVALID |
Varlık verileri geçerli değil. Öğe, Sipariş karşılama, Tanıtım olabilir. Varlık kimliği zorunludur. |
AVAILABILITY_CHANGED |
Öğe mevcut değil veya isteği yerine getirmek için yetersiz. Varlık kimliği zorunludur. |
PRICE_CHANGED |
Öğe fiyatı, öğe varlığındaki fiyattan farklı. Varlık kimliği ve güncellenmiş fiyat gerekir. |
INCORRECT_PRICE |
Ücretler, Toplam fiyat hataları. Varlık kimliği ve güncellenmiş fiyat gerekir. |
REQUIREMENTS_NOT_MET |
Sipariş kabuliyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.). |
TOO_LATE |
FulfillmentOption'ın süresi doldu. |
NO_CAPACITY |
Kullanılabilir hizmet kapasitesi yok. Daha ayrıntılı hata türlerinden hiçbiri geçerli değilse bu hata kodunu kullanın. |
NO_COURIER_AVAILABLE |
Teslimat kuryesi bulunamadı. NO_CAPACITY olarak sınıflandırılabilen ayrıntılı bir hata türü. |
INELIGIBLE |
Kullanıcı sipariş vermeye uygun değil (kara listede). |
OUT_OF_SERVICE_AREA |
Sınır kuralları vb. nedeniyle istenen adrese teslim edilemedi. |
CLOSED |
Restoran, sipariş saatinde çalışma nedeniyle kapalıdır. |
PROMO_NOT_APPLICABLE |
Aşağıdakilerin hiçbiri uygun değilse, promosyon kodu uygulanamadı tüm durumları yakalamak için kullanılan genel hata kodu. Promosyon kodunu Varlık Kimliği olarak ekleyin. |
PROMO_NOT_RECOGNIZED |
Kupon kodu, iş ortağı tarafından tanınmadı. Promosyon kodunu Varlık Kimliği olarak ekleyin. |
PROMO_EXPIRED |
Promosyonun süresi dolduğundan uygulanamadı. Promosyon kodunu Varlık Kimliği olarak ekleyin. |
PROMO_USER_INELIGIBLE |
Geçerli kullanıcı bu kuponu almak için uygun değil. Promosyon kodunu Varlık Kimliği olarak ekleyin. |
PROMO_ORDER_INELIGIBLE |
Geçerli sipariş bu kupon için uygun değil. Promosyon kodunu Varlık Kimliği olarak ekleyin. |
UNAVAILABLE_SLOT |
Önceden sipariş aralığı kullanılamıyor. |
FAILED_PRECONDITION |
Sipariş kabuliyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.) |
PAYMENT_DECLINED |
Geçersiz ödeme. |
MERCHANT_UNREACHABLE |
Satıcıya ulaşılamıyor. Bu, bir iş ortağının toplayıcı olmasına rağmen satıcıya ulaşamadığı durumlarda yardımcı olur. |
ACCOUNT_LINKING_FAILED |
Satıcı, kullanıcının Google hesabını sistemindeki bir hesaba bağlamaya çalıştı ancak bunu yaparken bir hatayla karşılaştı. |
TicketOrderExtension
Film, spor vb. bilet siparişlerinin içeriği
JSON gösterimi | |
---|---|
{
"ticketEvent": {
object ( |
Alanlar | |
---|---|
ticketEvent |
Tüm satır öğesi biletlerine uygulanan etkinlik. |
TicketEvent
Tek bir etkinliği temsil eder.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Zorunlu: Bilet etkinliğinin türü, ör. film, konser. |
name |
Zorunlu: Etkinliğin adı. Örneğin, etkinlik bir filmse bu film adı olmalıdır. |
description |
Etkinliğin açıklaması. |
url |
Etkinlik bilgisinin URL'si. |
location |
Etkinliğin gerçekleştiği veya kuruluşun bulunduğu konum. |
eventCharacters[] |
Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya oyuncuları ya da bir konserin performansları vb. olabilir. |
startDate |
Başlangıç zamanı. |
endDate |
Bitiş zamanı. |
doorTime |
Giriş saati. Bu saat, etkinlik başlangıç zamanından farklı olabilir. ör. Etkinlik sabah 9'da başlıyor, ancak giriş saati 08:30. |
Tür
Etkinliğin türü.
Sıralamalar | |
---|---|
EVENT_TYPE_UNKNOWN |
Bilinmeyen etkinlik türü. |
MOVIE |
Film. |
CONCERT |
Konser. |
SPORTS |
Spor. |
EventCharacter
Bir etkinlik karakteri, ör. düzenleyen, sanatçı vb.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Etkinlik karakterinin türü, ör. oyuncu ya da yönetmen. |
name |
Karakterin adı. |
image |
Karakterin resimleri. |
Tür
Karakter türü.
Sıralamalar | |
---|---|
TYPE_UNKNOWN |
Bilinmeyen tür. |
ACTOR |
İşlemi gerçekleştiren. |
PERFORMER |
Performans uzmanı. |
DIRECTOR |
Yönetmen. |
ORGANIZER |
Düzenleyen. |
UserNotification
Sipariş güncellemesinin bir parçası olarak gösterilecek isteğe bağlı kullanıcı bildirimi.
JSON gösterimi | |
---|---|
{ "title": string, "text": string } |
Alanlar | |
---|---|
title |
Kullanıcı bildiriminin başlığı. İzin verilen maksimum uzunluk 30 karakterdir. |
text |
Bildirimin içeriği. İzin verilen maksimum uzunluk 100 karakterdir. |
NextScene
Sonraki yürütülecek sahneyi gösterir.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Sonraki yürütülecek sahnenin adı. |
Oturum
Mevcut sohbet oturumuyla ilgili bilgiler içerir
JSON gösterimi | |
---|---|
{
"id": string,
"params": {
string: value,
...
},
"typeOverrides": [
{
object ( |
Alanlar | |
---|---|
id |
Zorunlu. Geçerli sohbet oturumunun genel olarak benzersiz kimliği. Bu alan salt okunurdur. |
params |
Zorunlu. Oturum sırasında formlardan ve amaçlardan toplanan tüm parametrelerin listesi. Anahtar, parametre adıdır. Burada tanımlanan parametreler, oturumda önceden tanımlanmış parametrelerle birleştirilir. Null değerine sahip parametreler oturumdan kaldırılır. Oturum depolama dokümanlarını şu adreste bulabilirsiniz: https://developers.google.com/assistant/conversational/storage-session.
|
typeOverrides[] |
İsteğe bağlı. Oturumun kapsamında olan türler. Tanımladığı oturum türü, mevcut türleri destekleyebilir veya değiştirebilir. Tür adları benzersiz olmalıdır. |
languageCode |
Geçerli sohbet oturumunun dili. IETF BCP-47 dil kodunu (http://www.rfc-editor.org/rfc/bcp/bcp47.txt) izler. İşlem birden fazla dil özelliğini kullanıyorsa bu, kullanıcının yerel ayarından farklı olabilir. Örneğin, işleyici_yanıtı.beklenen.dil_kodu ayarlandığında sonraki tüm dönüşler için sohbet dilini değiştirir ve bu işlem bu alana yansıtılır. |
TypeOverride
Bir tür için geçersiz kılmayı temsil eder.
JSON gösterimi | |
---|---|
{ "name": string, "mode": enum ( |
Alanlar | |
---|---|
name |
Zorunlu. Eklenecek veya geçersiz kılınacak türün adı. |
mode |
Zorunlu. Bu türün diğer tür değerleriyle nasıl birleştirilmesi gerektiği. |
synonym |
|
TypeOverrideMode
Oturum öğe türündeki değişikliklerin türleri.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Belirtilmedi. Bu değer hiçbir zaman kullanılmamalıdır. |
TYPE_REPLACE |
Bu yanıttaki tür tanımları, daha önce tanımlanan tür tanımlarının yerini alacak. |
TYPE_MERGE |
Bu yanıttaki tür tanımları, daha önce tanımlanan tür tanımlarıyla birleştirilir. Yeni tür tanımları, mevcut tür tanımlarının üzerine yazılır. |
SynonymType
Eş anlamlılar içeren bir türü gösterir.
JSON gösterimi | |
---|---|
{
"entries": [
{
object ( |
Alanlar | |
---|---|
entries[] |
Zorunlu. Eş anlamlı türü girişlerinin listesi. |
Giriş
Eş anlamlı bir tür girişi temsil eder.
JSON gösterimi | |
---|---|
{
"name": string,
"synonyms": [
string
],
"display": {
object ( |
Alanlar | |
---|---|
name |
Zorunlu. Girişin adı (ör. "bisiklet"). Bu alandaki girişin, geçerli bir tür değeri olarak tanınabilmesi için tekrarlanan eş anlamlılar alanına eklenmesi gerekir. |
synonyms[] |
Zorunlu. Giriş için eş anlamlıların listesi (ör. "bisiklet", "bisiklet"). |
display |
İsteğe bağlı. Öğeyle ilgili bilgiler gösterilir. |
EntryDisplay
JSON gösterimi | |
---|---|
{ "title": string, "description": string, "image": { object ( |
Alanlar | |
---|---|
title |
Zorunlu. Öğenin başlığı. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, koleksiyon öğeleri grubu içinde benzersiz olmalıdır. |
description |
İsteğe bağlı. Kartın gövde metni. |
image |
İsteğe bağlı. Gösterilecek resim. |
footer |
İsteğe bağlı. Göz atma koleksiyonu öğesi için açıklamanın altında görüntülenen altbilgi metni. Üç nokta ile kısaltılmış tek satır metin. |
openUrl |
Göz atma bandı öğesiyle ilişkili dokümanın URL'si. Banda göz atmak için gereklidir. |
Kullanıcı
İşlem için istekte bulunan kullanıcıyı temsil eder.
JSON gösterimi | |
---|---|
{ "locale": string, "params": { string: value, ... }, "accountLinkingStatus": enum ( |
Alanlar | |
---|---|
locale |
İstekte bulunan kullanıcının birincil yerel ayarı. IETF BCP-47 dil kodunu (http://www.rfc-editor.org/rfc/bcp/bcp47.txt) izler. Ancak komut dosyası alt etiketi dahil edilmez. |
params |
İsteğe bağlı. Geçerli kullanıcıyla ilişkilendirilen tüm parametrelerin listesi. Kullanıcı depolama alanı dokümanlarını şu adreste bulabilirsiniz: https://developers.google.com/assistant/conversational/storage-user.
|
accountLinkingStatus |
Kullanıcı hesabının uygulamaya bağlı olup olmadığı. |
verificationStatus |
Kullanıcının doğrulama durumunu gösterir. |
lastSeenTime |
Bu kullanıcıyla son etkileşimin zaman damgası. Kullanıcı daha önce temsilciyle etkileşimde bulunmadıysa bu alan atlanır. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
engagement |
Amaca yönelik tüm abonelikler de dahil olmak üzere geçerli kullanıcının etkileşimi. |
packageEntitlements[] |
Kullanıcının geçerli işlemle ilişkili Android paketiyle ilgili yararlanma hakları. |
permissions[] |
Kullanıcı tarafından bu İşlem için verilen izinleri içerir. |
AccountLinkingStatus
Son kullanıcının hesabını bu uygulamaya bağlayıp bağlamadığını belirtir. Hesap bağlama belgelerine bakın: https://developers.google.com/assistant/identity.
Sıralamalar | |
---|---|
ACCOUNT_LINKING_STATUS_UNSPECIFIED |
Bilinmiyor. |
NOT_LINKED |
Kullanıcı, hesabını bu uygulamaya bağlamadı. |
LINKED |
Kullanıcı, hesabını bu uygulamaya bağladı. |
UserVerificationStatus
Google'ın kullanıcıyı doğrulayıp doğrulamadığını belirtir. DOĞRULANDI durumu, parametreler alanını kullanarak veya hesap bağlama yoluyla verileri görüşmeler arasında kaydedebileceğinizi belirtir.
Sıralamalar | |
---|---|
USER_VERIFICATION_STATUS_UNSPECIFIED |
Bilinmiyor. |
GUEST |
Misafir kullanıcı. |
VERIFIED |
Doğrulanmış kullanıcı. |
Etkileşim
Geçerli kullanıcının hangi etkileşim mekanizmalarına kaydolduğu hakkında salt okunur ek bilgiler sağlar. Örneğin, kullanıcının tekrar aynı amaca abone olmasını istememek için hangi amaçlara abone olduğunu bilmek yararlı olabilir. Diğer bir deyişle, bu bilgiler yalnızca kullanıcı henüz abone olmadıysa DailyUpdates veya PushBildirimleri ayarlamak üzere bir sahneye koşullu olarak yönlendirme yapmak için kullanılabilir. Kullanıcı etkileşimi belgelerini inceleyin: https://developers.google.com/assistant/engagement.
JSON gösterimi | |
---|---|
{ "pushNotificationIntents": [ { object ( |
Alanlar | |
---|---|
pushNotificationIntents[] |
Kullanıcının push bildirimini etkinleştirdiği amaçların listesini içerir. |
dailyUpdateIntents[] |
Kullanıcının günlük güncellemeyi etkinleştirdiği amaçların listesini içerir. |
IntentSubscription
Mevcut bir IntentSubscription tanımlar.
JSON gösterimi | |
---|---|
{ "intent": string, "contentTitle": string } |
Alanlar | |
---|---|
intent |
Abone olunan amacın adı. |
contentTitle |
Aboneliğin kısa bir açıklaması. Bu ad, bildirimin etiketi olarak ve Asistan kullanıcıdan izin istediğinde kullanılır. |
PackageEntitlements
Kullanıcının bir paket adıyla ilgili haklarının listesi. Dijital iyi işlem belgelerini şu adreste bulabilirsiniz: https://developers.google.com/assistant/transactions/digital/dev-guide-digital-non-consumables.
JSON gösterimi | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Alanlar | |
---|---|
packageName |
İşlem paketinde belirtilen Android paketi adı. |
entitlements[] |
Kullanıcının belirtilen paketten yararlanma hakları. |
Hak
Kullanıcının dijital haklarını tanımlar.
JSON gösterimi | |
---|---|
{ "sku": string, "skuType": enum ( |
Alanlar | |
---|---|
sku |
Ürün SKU'su. Ücretli uygulama için paket adı, uygulama içi satın alma ve uygulama içi abonelik için Finsky docid son eki. Play InApp Faturalandırma API'sinde getSku() ile eşleştirin. Play Uygulama İçi Faturalandırma belgelerini inceleyin: https://developer.android.com/google/play/billing. |
skuType |
SKU'nun türü. |
inAppDetails |
Yalnızca uygulama içi satın alma işlemleri ve uygulama içi aboneler için geçerlidir. |
SkuType
Sıralamalar | |
---|---|
SKU_TYPE_UNSPECIFIED |
|
IN_APP |
Uygulama içi satın alma |
SUBSCRIPTION |
Abonelikler |
APP |
Ücretli uygulamalar |
SignedData
JSON gösterimi | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Alanlar | |
---|---|
inAppPurchaseData |
Tüm uygulama içi satın alma verilerini JSON biçiminde içerir. Ayrıntıları https://developer.android.com/google/play/billing/billing_reference.html adresindeki tabloda 6. tabloda bulabilirsiniz. |
inAppDataSignature |
Play InApp Faturalandırma API'sinde getPurchases() yönteminden IN_APP_DATA_SIGNATURE ile eşleşir. |
İzin
İzin için olası değerler.
Sıralamalar | |
---|---|
PERMISSION_UNSPECIFIED |
Belirtilmemiş izin. |
DEVICE_PRECISE_LOCATION |
Kullanıcının tam konumunu, enlem/boylamını ve biçimlendirilmiş adresini isteyin. |
DEVICE_COARSE_LOCATION |
Kullanıcının yaklaşık konumunu, posta kodunu, şehir ve ülke kodunu isteyin. |
UPDATE |
Güncelleme göndermek için izin isteyin. https://developers.google.com/assistant/engagement/daily adresini ziyaret edin. |
Ana Sayfa
Kullanıcının hedef cihazının ait olduğu HomeGraph yapısını gösterir.
JSON gösterimi | |
---|---|
{ "params": { string: value, ... } } |
Alanlar | |
---|---|
params |
İsteğe bağlı. Hedef cihazın ait olduğu HomeGraph yapısıyla ilişkili parametrelerin listesi. Ev depolama alanı dokümanlarını şu adreste bulabilirsiniz: https://developers.google.com/assistant/conversational/storage-home.
|
Cihaz
Kullanıcının Action'a istekte bulunmak için kullandığı cihazı gösterir.
JSON gösterimi | |
---|---|
{ "capabilities": [ enum ( |
Alanlar | |
---|---|
capabilities[] |
Zorunludur. cihazın İşlem için istekte bulunma özellikleri. |
currentLocation |
İsteğe bağlı. Kullanıcının cihaz konumu. Bu alanın yalnızca son kullanıcı tarafından konum izinleri verildikten sonra doldurulacağını unutmayın. Hangi alanların genel veya ayrıntılı izinlere göre ayarlandığı hakkında daha fazla bilgi için konum mesajına bakın. İzin belgelerine bakın: https://developers.google.com/assistant/conversational/permissions. |
timeZone |
İsteğe bağlı. İstemci cihazla ilişkilendirilen saat dilimi. Tarih ve saat değerlerini çözümlemek için kullanılabilir. |
Kapasite
İstek sırasında cihaz yüzeyinin desteklediği özellikler.
Sıralamalar | |
---|---|
UNSPECIFIED |
Belirtilmemiş cihaz özelliği. |
SPEECH |
Cihaz, metin okuma veya SSML üzerinden kullanıcıyla konuşabilir. |
RICH_RESPONSE |
Cihaz; kartlar, listeler ve tablolar gibi zengin yanıtları görüntüleyebilir. |
LONG_FORM_AUDIO |
Cihaz, müzik ve podcast gibi uzun biçimli sesli medyaları oynatabilir. |
INTERACTIVE_CANVAS |
Cihazda etkileşimli bir tuval yanıtı gösterilebilir. |
WEB_LINK |
Cihaz, bir web tarayıcısını açmak için zengin yanıtlardaki web bağlantılarını kullanabilir. |
HOME_STORAGE |
Cihaz, ev depolama alanının kaydedilmesini ve getirilmesini destekleyebilir. |
Konum
Bir konumu temsil eden kapsayıcı.
JSON gösterimi | |
---|---|
{ "coordinates": { object ( |
Alanlar | |
---|---|
coordinates |
Coğrafi koordinatlar. [DEVICE_PRECISE_LOCATION] iznini gerektirir. |
postalAddress |
Posta adresi. [DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] iznini gerektirir. Yaklaşık konum izni verildiğinde yalnızca "postalCode" ve "locality" alanlarının doldurulması gerekir. Tam konum izni, "administrativeArea" gibi ek alanları doldurur ve "addressLines". |
TimeZone
IANA Saat Dilimi Veritabanı'ndan bir saat dilimini temsil eder.
JSON gösterimi | |
---|---|
{ "id": string, "version": string } |
Alanlar | |
---|---|
id |
IANA Saat Dilimi Veritabanı saat dilimi, ör. "Amerika/New_York". |
version |
İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası, ör. "2019a". |
Bağlam
Kullanıcı sorgu yaptığında bağlam bilgilerini içerir. Etkin medya oturumu, tuval web uygulamasının durumu vb. hakkındaki bilgiler bu kapsamda değerlendirilir.
JSON gösterimi | |
---|---|
{ "media": { object ( |
Alanlar | |
---|---|
media |
Mevcut etkin medya oturumuyla ilgili bağlam bilgilerini içerir. |
canvas |
Geçerli tuvalle ilgili bağlam bilgilerini içerir. |
MediaContext
Mevcut etkin medya oturumuyla ilgili bağlam bilgilerini içerir.
JSON gösterimi | |
---|---|
{ "progress": string, "index": integer } |
Alanlar | |
---|---|
progress |
Mevcut etkin medya dosyasının medya ilerleme durumu. En fazla dokuz kesirli basamağa sahip, " |
index |
Medya yanıtındaki medya dosyaları listesindeki geçerli etkin medya dosyasının 0 tabanlı dizini. |
CanvasContext
Geçerli tuvalle ilgili bağlam bilgilerini içerir.
JSON gösterimi | |
---|---|
{ "state": value } |
Alanlar | |
---|---|
state |
İsteğe bağlı. Durum, üçüncü taraf etkileşimli Tuval uygulaması tarafından belirlendi. Bu ayar yalnızca istek için belirlenir, yanıt için değildir. Örneğin, bu bir yemek tarifi uygulamasıysa durum struct : { "current_page" : 5, "son_sayfa" : 3, } Boyut sınırı 50 KB'tır. |
Beklenen
Bir sonraki diyalog dönüşü için beklentileri açıklar.
JSON gösterimi | |
---|---|
{ "speech": [ string ] } |
Alanlar | |
---|---|
speech[] |
İşlemin konuşmaya ağırlık verme için kullanıcının ifadesinden beklediği ifadelerin listesi. En fazla 1.000 ifadeye izin verilir. Not: Bu alan, v2 API'deki ExpectInput.speech_biasing_hints ile aynı anlama sahiptir. |