- HTTP isteği
- İstek metni
- Yanıt metni
- İşleyici
- Amaç
- IntentParameterValue
- Sahne
- SlotFillingStatus
- Yuva
- SlotMode
- SlotStatus
- İstem
- Basit
- İçerik
- Kart
- Resim
- ImageFill
- Bağlantı
- OpenUrl
- UrlHint
- Tablo
- TableColumn
- HorizontalAlignment
- TableRow
- TableCell
- Medya
- MediaType
- OptionalMediaControls
- MediaObject
- MediaImage
- RepeatMode
- Toplama
- CollectionItem
- Liste
- ListItem
- CollectionBrowse
- Öğe
- Öneri
- Tuval
- ContinuousMatchConfig
- ExpectedPhrase
- OrderUpdate
- Tür
- Sipariş
- UserInfo
- PhoneNumber
- Resim
- Satıcı
- Konum
- 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 (Tür Geçersiz Kılma)
- TypeOverrideMode
- SynonymType
- Giriş
- EntryDisplay
- Kullanıcı
- AccountLinkingStatus
- UserVerificationStatus
- Etkileşim
- IntentSubscription
- PackageEntitlements
- Yararlanma hakkı
- SkuType
- SignedData
- İzin
- Ana Sayfa
- Cihaz
- Kapasite
- Konum
- TimeZone
- Bağlam
- MediaContext
- CanvasContext
- Beklenen
Sipariş karşılama API'sini temsil eden RPC
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ıyla birlikte veriler 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" adlı bir işleyici olabilir. |
intent |
Zorunlu. Son eşleşen amacı temsil eder. https://developers.google.com/assistant/conversational/intents adresine göz atın. |
scene |
İsteğe bağlı. İşlevin çağrıldığı geçerli sahne ve sonraki sahne hakkında bilgi. Bir sahne kapsamında sipariş karşılama araması 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 saklar. |
user |
Zorunlu. Görüşmeyi başlatan kullanıcı. |
home |
İsteğe bağlı. Hedef cihazın ait olduğu Home Graph yapısıyla ilgili bilgiler. https://developers.google.com/actions/smarthome/concepts/homegraph adresine göz atın. |
device |
Zorunlu. Kullanıcının İşlem ile etkileşim kurmak için kullandığı cihazdaki bilgiler. |
context |
İsteğe bağlı. İsteğin mevcut bağlamına dair 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 isteği karşılamasından 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 iletilere eklenir. |
scene |
İsteğe bağlı. Mevcut sahneyi ve sonraki sahneyi temsil eder. |
session |
İsteğe bağlı. Mevcut oturuma ait 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 Home Graph yapısıyla ilgili parametreleri belirtmek için kullanılır. https://developers.google.com/actions/smarthome/concepts/homegraph adresine göz atın. |
device |
İsteğe bağlı. Kullanıcının erişebildiği Asistan cihazları arasında hareket etmek için kullanın. |
expected |
İsteğe bağlı. Diyaloğun bir sonraki dönüşü için beklentileri açıklar. |
İşleyici
Actions on Google'daki etkinlik bilgilerini istek karşılamayla eşleyen bir sipariş karşılama işleyicisini temsil eder. Sipariş karşılamada hangi kodu çalıştırmanız gerektiğini belirlemek için işleyici adını kullanın. Örneğin, bir işleyici "OrderLookup" gibi bir işleyici adıyla bir kullanıcının sipariş bilgileri hakkında bilgi almak için kullanılabilirken başka bir işleyici, "GetProductInfo" gibi bir işleyici adıyla bir veritabanından ürün bilgileri alabilir.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
İsteğe bağlı. İşleyicinin adı. |
Amaç
Bir amacı 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. Burada, tanımlanan parametre adı ile kullanıcı girişinden tanımlanan parametre değeri karşılaştırılır. 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ü girişi. Bu alan, bir amaç eşleştirildiğinde kullanıcı girişine göre doldurulur. |
IntentParameterValue
Amaç parametresi değerini temsil eder. https://developers.google.com/assistant/conversational/types adresine göz atın.
JSON gösterimi | |
---|---|
{ "original": string, "resolved": value } |
Alanlar | |
---|---|
original |
Zorunlu. Kullanıcının ifadesinden alınan orijinal metin değeri. |
resolved |
Zorunlu. Kullanıcı girişinden çıkarılan parametre için yapılandırılmış değer. Bu alan yalnızca parametre, eşleşen amaçta tanımlanmışsa ve parametre değeri amaç eşleştirme sırasında tanımlanabilirse doldurulur. |
Düzen
Bir sahneyi temsil edin. Sahneler istek karşılamayı arayabilir, istem ekleyebilir ve kullanıcıdan slot değerleri toplayabilir. Sahneler, etkinlikler veya amaçlar tarafından tetiklenir. Bu sahneler, etkinlikleri ve eşleşme amaçlarını diğer sahnelere geçiş yapacak şekilde tetikleyebilir.
JSON gösterimi | |
---|---|
{ "name": string, "slotFillingStatus": enum ( |
Alanlar | |
---|---|
name |
Zorunlu. Geçerli sahnenin adı. |
slotFillingStatus |
Zorunlu. Slot doldurmanın mevcut durumu. Bu alan salt okunurdur. |
slots |
Geçerli sahneyle ilişkilendirilen alanlar. İşleyici yanıtları, istekte gönderilmemiş yuvaları döndüremez.
|
next |
İsteğe bağlı. Bir sonraki yürütülecek sahneyle ilgili bilgiler. |
SlotFillingStatus
Slot doldurmanın mevcut durumunu gösterir.
Sıralamalar | |
---|---|
UNSPECIFIED |
Kullanım alanı doldurulmadığında kullanılacak yedek değer. |
INITIALIZED |
Slotlar başlatıldı ancak slot doldurma işlemi başlatılmadı. |
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 |
Yuvanın modu (zorunlu veya isteğe bağlı). Geliştirici tarafından ayarlanabilir. |
status |
Alanın durumu. |
value |
Alanın değeri. Yanıtta bu değer değiştirildiğinde, slot doldurma değeri de değişir. |
updated |
Slot değerinin son dönüşte toplanıp toplanmadığını gösterir. Bu alan salt okunurdur. |
prompt |
İsteğe bağlı. Gerekli bir alanı doldurması gerektiğinde bu istem kullanıcıya gönderilir. Bu istem, konsolda tanımlanan mevcut istemi geçersiz kılar. Bu alan, webhook isteğine dahil değildir. |
SlotMode
Bir slotun modunu, yani gerekli olup olmadığını gösterir.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Kullanım alanı doldurulmadığında kullanılacak yedek değer. |
OPTIONAL |
Slot doldurma işlemini tamamlamak için gerekli olmadığını gösterir. |
REQUIRED |
Slot doldurmanın tamamlanması için alanın gerekli olduğunu gösterir. |
SlotStatus
Bir alanın durumunu gösterir.
Sıralamalar | |
---|---|
SLOT_UNSPECIFIED |
Kullanım alanı doldurulmadığında kullanılacak yedek değer. |
EMPTY |
Alanın herhangi bir değere sahip olmadığını gösterir. Bu durum, yanıt aracılığıyla değiştirilemez. |
INVALID |
Alan değerinin geçersiz olduğunu belirtir. Bu durum, alınan 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
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 mesajların önceden tanımlanmış iletilerle nasıl birleştirileceğini belirleyen mod. "true", önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "false", bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alanın "false" olarak bırakılması, Basit istemler, Öneriler istemi ve Tuval istemi (İçerik isteminin bir bölümü) içindeki bazı alanlara da eklenmesine olanak tanır. İstemde tanımlanırsa İçerik ve Bağlantı mesajlarının her zaman üzerine yazılır. Varsayılan değer "false" (yanlış) değeridir. |
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ı. Sesli ve yalnızca metin içeren son yanıt. |
suggestions[] |
İsteğe bağlı. Öneriler her zaman yanıtın sonunda görünür ve kullanıcıya gösterilir. İçeren istemdeki "geçersiz kıl" alanı "false" (yanlış) değerine ayarlanırsa bu alanda tanımlanan başlıklar, önceden tanımlanmış öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır. |
link |
İsteğe bağlı. İlişkilendirilmiş uygulamaya veya siteye bağlantı verebilen ek bir öneri çipi. Çip, "Aç (ad)" başlığıyla oluşturulur. Maks. 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ı İşlem, işlem akışı sırasında siparişi aldıktan sonra Sipariş Güncellemesi ile yanıt veriyor. Bunu aldıktan sonra, Google siparişle ilgili bu güncellemeyi kaydeder ve başarılı olursa ekran cihazlarında gönderilen TTS ile birlikte bir makbuz kartı görüntüler. |
Basit
Kullanıcıya gönderilecek 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 konuşulacak konuşmayı temsil eder. SSML veya metin okuma olabilir. İçeren istemdeki "geçersiz kıl" alanı "true" (doğru) değerine sahipse 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österilecek isteğe bağlı metin. Sağlanmazsa yukarıdaki konuşma alanının bir ekran oluşturma işlemi kullanılır. Uzunluk sınırı 640 karakterdir. İçeren istemdeki "geçersiz kıl" alanı "true" (doğru) değerine sahipse 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 | ||
---|---|---|
|
||
card |
Temel bir kart. |
|
image |
Bir resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak medya grubunu belirten yanıt. |
|
collection |
Aralarından seçim yapabileceğiniz bir dizi seçenek sunan kart. |
|
list |
Aralarından seçim yapabileceğiniz seçeneklerin listesini gösteren bir kart. |
|
collectionBrowse |
Açılacak web sayfaları koleksiyonunu gösteren bir kart. |
Kart
Bazı bilgileri (ör. resim ve/veya metin) gösteren temel bir kart. 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 dizimini destekler. Resim yoksa gereklidir. |
image |
Kartın lokomotif resmi. Yükseklik 192 dp'ye sabitlenir. İ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 gösterilen bir resim. https://developers.google.com/assistant/conversational/prompts-rich#image-cards adresine göz atın.
JSON gösterimi | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve 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 etkilemek için kullanılabilecek olası resim görüntüleme seçenekleri. Bu, resmin en boy oranı, resim kapsayıcısının en boy oranıyla eşleşmediğinde kullanılmalıdır.
Sıralamalar | |
---|---|
UNSPECIFIED |
|
GRAY |
Resim ile resim kapsayıcısı arasındaki boşlukları gri çubuklarla doldurun. |
WHITE |
Resim ile resim kapsayıcısı arasındaki boşlukları beyaz çubuklarla doldurun. |
CROPPED |
Resim, resim genişliği ve yüksekliği kapsayıcı boyutlarıyla eşleşecek veya bu boyutları aşacak şekilde ölçeklendirilir. Ölçeklendirilmiş resmin yüksekliği kapsayıcı yüksekliğinden fazlaysa resmin üst ve alt kısmı kırpılabilir. Ölçeklendirilmiş resmin genişliği kapsayıcı genişliğinden fazlaysa resmin sol ve sağ tarafı kırpılabilir. Bu, 4:3 oranındaki bir video oynatırken geniş ekran TV'deki "Yakınlaştırma Modu"na benzer. |
Bağlantı
İlişkilendirilmiş uygulamaya veya siteye bağlantı verebilen 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ı. Maksimum 20 karakter |
open |
Bir 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ı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri |
hint |
URL türüyle ilgili bir ipucu gösterir. |
UrlHint
Farklı URL ipucu 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 bir URL'ye yönlendiren URL. https://amp.dev/ adresine bakın. |
Tablo
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 altyazı 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österilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi satırların gösterileceğini görmek üzere lütfen simülatörle test yapın. WEB_BROWSER işlevini 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 |
İçeriğin sütunla yatay hizalaması. Belirtilmemişse içerik ön kenara hizalanır. |
HorizontalAlignment
Hücre içindeki içeriğin hizalaması.
Sıralamalar | |
---|---|
UNSPECIFIED |
|
LEADING |
Hücrenin baş kenarı. Bu varsayılan seçenektir. |
CENTER |
İçerik, sütunun ortasına hizalanır. |
TRAILING |
İçerik, sütunun son kenarına 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österilmesi 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ülatörle test yapın. |
divider |
Her satırdan sonra ayırıcı olup olmadığını gösterir. |
TableCell
Bir satırdaki 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 kesir basamağı içeren ve " |
optionalMediaControls[] |
Bu medya yanıt oturumunun destekleyebileceği isteğe bağlı medya denetimi türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3p'ye istek gönderilir. Ayarlanmazsa 3p yine de TAMAM ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir. |
mediaObjects[] |
Medya Nesneleri Listesi |
repeatMode |
Medya Nesneleri listesi için modu tekrar edin. |
firstMediaObjectIndex |
Oynatılacak medyaObjects'teki ilk Medya Nesnesi'nin 0 tabanlı dizini. Belirtilmemişse, sıfır veya sınırların dışındaysa oynatma, mediaObjects'teki ilk medya nesnesinden 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 denetimi türleri
Sıralamalar | |
---|---|
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED |
Değer belirtilmemiş |
PAUSED |
Etkinlik duraklatıldı. Kullanıcı medyayı duraklattığında tetiklenir. |
STOPPED |
Etkinlik durduruldu. Kullanıcı, medya oynatma sırasında 3p oturumundan çı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 işaret eden URL. MP3 dosyaları bir web sunucusunda barındırılmalı ve HTTPS URL'si üzerinden herkese açık olmalıdır. Canlı yayın yalnızca MP3 biçimi için desteklenir. |
image |
Medya kartıyla birlikte gösterilecek resim. |
MediaImage
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
|
||
large |
Albümün kapağı vb. büyük bir resim. |
|
icon |
Başlığın sağında gösterilen küçük resim simgesi. 36x36 dp olarak yeniden boyutlandırıldı. |
RepeatMode
Medya nesneleri listesi için tekrar modu türleri.
Sıralamalar | |
---|---|
REPEAT_MODE_UNSPECIFIED |
KAPALI değerine 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ü. |
Koleksiyon
Aralarından seçim yapabileceğiniz bir dizi seçeneği sunan 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. 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ür'deki giriş anahtarı adıyla eşleşen NLU anahtarı. |
Liste
Aralarından seçim yapabileceğ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. En az 2, en fazla 30 olabilir. |
ListItem
Listedeki bir öğe
JSON gösterimi | |
---|---|
{ "key": string } |
Alanlar | |
---|---|
key |
Zorunlu. İlişkili Tür'deki giriş anahtarı adıyla eşleşen NLU anahtarı. |
CollectionBrowse
Bir dizi web dokümanı, büyük parçalardan oluşan bir koleksiyon olarak sunulur. Öğeler, ilişkili web dokümanını bir web görüntüleyicide başlatmak için seçilebilir. https://developers.google.com/assistant/conversational/prompts-selection#collectionBrowse göz atın.
JSON gösterimi | |
---|---|
{ "items": [ { object ( |
Alanlar | |
---|---|
items[] |
Öğe listesi. En az 2, en fazla 10 olabilir. |
imageFill |
Resim görüntüleme seçeneğinin türü. |
Öğe
Öğe koleksiyonda.
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 öğesinin açıklamanın altında görüntülenen altbilgi metni. Üç nokta ile kısaltılmış tek satırlık metin. |
image |
Koleksiyon öğesinin resmi. |
openUriAction |
Zorunlu. Öğe seçilmişse açılacak URI. |
Öneri
Öneriler, Asistan istemi görüntülediğinde görüntüleme özellikli cihazlardaki kullanıcılara öneri çipleri sağlar. Görüşmeyi sürdürmek veya değiştirmek amacıyla kullanıcı yanıtlarına ipucu vermek için öneri çiplerini kullanın. Öneri çipi dokunulduğunda, görüntülenen metni kullanıcı yazmış gibi tam olarak görüşmede döndürür. 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 metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Öneri çipi grubundaki her başlık benzersiz olmalıdır. Maks. 25 karakter |
Tuval
Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, etkileşimli bir tuval yanıtı görüntülemenin yanı sıra kullanıcıyla konuşmayı içeren istemdeki "first Simple" alanıyla birlikte kullanılabilir. Yanıtın maksimum boyutu 50.000 bayttır. https://developers.google.com/assistant/interactivecanvas adresine göz atın.
JSON gösterimi | |
---|---|
{
"url": string,
"data": [
value
],
"suppressMic": boolean,
"continuousMatchConfig": {
object ( |
Alanlar | |
---|---|
url |
Yüklenecek etkileşimli tuval web uygulamasının URL'si. Ayarlanmazsa mevcut etkin tuvaldeki URL yeniden kullanılır. |
data[] |
İsteğe bağlı. Kapsamlı deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. İçeren istemdeki "geçersiz kıl" alanı "false" (yanlış) değerine sahipse bu Canvas isteminde tanımlanan veri değerleri önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenir. |
suppressMic |
İsteğe bağlı. Varsayılan değer: false. |
continuousMatchConfig |
Sürekli eşleşme modunu başlatmak için kullanılan yapılandırma. |
ContinuousMatchConfig
Sürekli eşleşme modunu başlatmak için kullanılan yapılandırma.
JSON gösterimi | |
---|---|
{
"expectedPhrases": [
{
object ( |
Alanlar | |
---|---|
expectedPhrases[] |
Bu sürekli eşleme modu oturumunda, beklenen tüm olası ifadeler. |
durationSeconds |
Sürekli eşleşme modunun açık tutulacağı süre. Belirtilmesi durumunda, 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ış tanınabilir. Bu, geliştiricilerin eşofmanlar için alternatif tetikleyiciler belirtmesine olanak tanır. |
OrderUpdate
Bir siparişe güncelleyin.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_mask kullanın. Tür = SNAPSHOT ise OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise, bu, sipariş düzeyi durum değişikliğidir. Yalnızca order.last_update_time ve bu sektör durumu alınır. Not: type.ORDER_STATUS, yalnızca PurcahaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamını genişletme planı yoktur. Bunun yerine, daha genel ve genişletilebilir olduğundan ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz. |
order |
|
updateMask |
Not: Aşağıdaki özel alanlarla ilgili olarak dikkate alınması gereken bazı noktalar/öneriler mevcuttur: 1. order.last_update_time, güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. updateMask ile sağlanmışsa order.create_time, order.google_order_id ve order.merchant_order_id dikkate alınmaz. Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: |
userNotification |
Belirtilmişse kullanıcıya belirtilen başlık ve metni içeren bir bildirim görüntüler. Bildirim belirlemek, bilgilendirme amaçlı bir öneridir ve bildirimle sonuçlanacağı garanti edilmez. |
reason |
Değişikliğin/güncellemenin nedeni. |
Tür
Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_mask kullanın. Bir siparişte güncelleme yapılmasına izin veriliyor.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi, açık bir şekilde ayarlanmamalıdır. |
ORDER_STATUS |
Yalnızca siparişin durumunu güncelleyin. |
SNAPSHOT |
Sipariş anlık görüntüsünü güncelleyin. |
Sipariş verin
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 alanların tümü 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 |
Gerekli: Satıcı tarafından atanan dahili sipariş kimliği. Bu kimlik benzersiz olmalı ve sonraki sipariş güncelleme işlemleri için gereklidir. Bu kimlik, sağlanan googleOrderId veya başka bir benzersiz değere ayarlanabilir. Kullanıcılara sunulan kimliğin userGörünenOrderId olduğunu ve bu farklı ve daha kullanıcı dostu bir değer olabileceğini unutmayın. İzin verilen maksimum uzunluk 128 karakterdir. |
|
userVisibleOrderId |
Mevcut siparişe referans veren kullanıcıya gösterilen kimlik. Bu kimlik web siteleri, uygulamalar ve e-posta dahil olmak üzere diğer bağlamlarda bu sipariş için görüntülenen kimlikle tutarlı olmalıdır. |
|
userVisibleStateLabel |
Kullanımdan kaldı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ı hakkında bilgi. |
|
image |
Siparişle ilişkilendirilen resim. |
|
createTime |
Gerekli: Siparişin oluşturulduğu tarih ve saat. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
|
lastUpdateTime |
Siparişin son güncellendiği tarih ve saat. Sipariş Güncellemesi için gereklidir. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
|
transactionMerchant |
Ödeme işlemini kolaylaştıran satıcı. Bu, satır öğesi seviyesindeki sağlayıcıdan farklı olabilir. Örnek: ANA'dan satır öğesi içeren Expedia Siparişi. |
|
contents |
Gerekli: Satır öğesi grubu olan sipariş içeriği. |
|
priceAttributes[] |
Fiyat, indirimler, vergiler vb. |
|
followUpActions[] |
Sipariş seviyesinde takip işlemleri. |
|
paymentData |
Sipariş için ödemeyle ilgili veriler. |
|
termsOfServiceUrl |
Sipariş/teklif edilen sipariş için geçerli olan hizmet şartlarının bağlantısı. |
|
note |
Bir siparişe ekli notlar. |
|
promotions[] |
Bu siparişle ilişkili tüm promosyonlar. |
|
disclosures[] |
Bu siparişle ilgili açıklamalar. |
|
vertical |
Kullanımdan kaldırıldı: Bunun yerine sektör kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu tema, satır öğesi düzeyi dikey türüyle eşleşmelidir. Olası değerler: Rastgele türde alanlar içeren bir nesne. |
|
verticals alanı. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu tema, satır öğesi düzeyi dikey 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ı bilgileri. Bu, bir siparişle ilişkili kullanıcı bilgilerini temsil etmek 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ı. |
PhoneNumber
Standart telefon numarası temsili.
JSON gösterimi | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
Alanlar | |
---|---|
e164PhoneNumber |
Uluslararası Telekomünikasyon Birliği (ITU) Önerisi E.164'te tanımlandığı şekilde E.164 biçimindeki telefon numarası. wiki bağlantısı: https://en.wikipedia.org/wiki/E.164 |
extension |
Maksimum 40 haneden oluşan bir sayı dizisi olarak tanımlanması dışında, uzantı ITU önerilerinde standart hale getirilmemiştir. Uzantıda baştaki sıfırın olası kullanımını telafi etmek için burada bir dize olarak tanımlanır (tanımlanmış bir standart olmadığından, kuruluşlar bunu yapma özgürlüğüne sahiptir). Rakamlar dışında, "," (beklemeyi belirtir) gibi diğer numara çevirme karakterleri burada depolanabilir. Örneğin, xxx-xxx-xxxx dahili numarası 123 için "123" uzantısıdır. |
preferredDomesticCarrierCode |
Bu telefon numarasını yurt içinde ararken tercih edilen operatör seçim kodu. Bazı ülkelerde sabit hatlardan cep telefonuna arama yaparken (veya tam tersi) çevrilmesi gereken kodlar da bu kapsamdadır. Örneğin, Kolumbiya'da bir cep telefonundan sabit hatlı bir telefona veya sabit hatlı bir cep telefonuna arama yaparken telefon numarasından önce "3"ün aranması gerekir. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code Bunun "tercih edilen" kod olduğunu, dolayısıyla diğer kodların da kullanılabileceğini unutmayın. |
Resim
Kartta gösterilen bir resim.
JSON gösterimi | |
---|---|
{ "url": string, "accessibilityText": string, "height": integer, "width": integer } |
Alanlar | |
---|---|
url |
Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve 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 öğesi 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 Bread"). |
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] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir. |
formattedAddress |
Görünen adres, ör. "Talatpaşa Bulvarı No.: 22, İstanbul, 34111". [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir. |
zipCode |
Posta kodu. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir. |
city |
Şehir. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir. |
postalAddress |
Posta adresi. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir. |
name |
Yerin adı. |
phoneNumber |
Konumun telefon numarası (ör. işletmenin bulunduğu konumun iletişim numarası veya teslimat konumunun 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 adresine bakın |
LatLng
Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çiftle 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. posta teslimatı veya ödeme adresleri için). Bir posta adresi belirtildiğinde posta hizmeti, öğeleri posta kutusu veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, şehirler, dağlar) modellemek için tasarlanmamıştır.
Tipik kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılması yoluyla oluşturulur.
Adres girme / düzenleme ile ilgili öneriler: - https://github.com/google/libaddressinput gibi i18n uyumlu bir adres widget'ı kullanın) - Bu alanın kullanıldığı ülkelerin dışındaki alanlara giriş veya düzenleme işlemleri için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağı hakkında 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 hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılı bilgi için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html sayfalarına göz atın. Örnek: İsviçre için "CH". |
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 adresin ülkesinde/bölgesinde kullanılan dillerden biriyle ya da harf çevirisiyle eşleştirilmiş dille eşleşmesi beklenir. Bu durum belirli ülkelerde biçimlendirmeyi etkileyebilir. Ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olması muhtemel bir varsayılan değeri belirtmek yerine atlanmalıdır. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler, posta kodlarını kullanmaz veya zorunlu kılmaz ancak posta kodlarının kullanıldığı yerlerde adresin diğer bölümleriyle ek doğrulama işlemini tetikleyebilir (ör. ABD'de eyalet/posta kodu doğrulaması). |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde bu değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya sadece "sektör kodu" (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili) temsil eden bir sayıdır. |
administrativeArea |
İsteğe bağlı. Bir ülkenin 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. Daha açık belirtmek gerekirse, İspanya için bu, özerk topluluk değil, ilçedir (ör. "Katalonya" değil, "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş 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 topluluğu, Birleşik Krallık posta şehri. Dünyada, yerelliklerin iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde yerelliği boş bırakın ve addressLines'ı kullanın. |
sublocality |
İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir. |
addressLines[] |
Bir adresin daha alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines'daki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer içerebileceğinden (ör. "Austin, TX"), satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bunun değişiklik gösterebileceği yerlerde (ör. Japonya), address_language ifadesini açıkça belirtmek için kullanılır (örneğin, büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu şekilde, adresin en belirgin satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, geri kalan tüm bilgilerin adres satırlarına yerleştirildiği bir AreaCode'dan oluşur. Böyle bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olsa da, en azından kısmen çözümlenene kadar adres bileşenlerinin hiçbiri hakkında anlamsal akıl yürütme yapılamaz. Yalnızca AreaCode ve addressLines içeren bir adres oluşturduğunuzda (adresin hangi bölümlerinin yerel konumlar veya idari alanlar olması gerektiğini tahmin etmek yerine) tamamen yapılandırılmamış adreslerin işlenmesi için önerilen yöntem coğrafi kodlamadır. |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "bakımı" bilgileri içerebilir. |
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 tema içeriyor. Bir sipariş veya alışveriş sepetinde aynı sektörden birden fazla satır öğesi olabilir. Alt satır öğeleri/eklentiler vb. kullanım alanlarına bağlı olarak dikey proto'larda 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 alanların tümü 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üzeyde durumu kullanın. Örneğin, satın alma işlemleri için PurchaseOrderExtension.status değerini kullanın. Bu satır öğesinin durumu için kullanıcı tarafından görülebilen etiket. |
|
provider |
Genel siparişten farklıysa belirli satır öğesinin sağlayıcısı. Örnek: Satır öğesi sağlayıcısı ANA ile Expedia siparişi. |
|
priceAttributes[] |
Satır öğesi seviyesinde fiyat ve düzenlemeler. |
|
followUpActions[] |
Satır öğesindeki takip işlemleri. |
|
recipients[] |
Satır öğesi düzeyindeki müşteriler, bu, Sipariş düzeyindeki alıcıdan farklı olabilir. Örnek: X kullanıcısı, Y adlı kullanıcının adı altında restoran rezervasyonu yapmış. |
|
image |
Varsa, bu öğeyle ilişkili küçük resim. |
|
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 ilgili açıklamalar. |
|
vertical |
Kullanımdan kaldırıldı: Bunun yerine sektör kullanın. Gerekli: Satır öğesinin türüne/sektörüne göre 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ürde alanlar içeren bir nesne. |
|
verticals alanı. Gerekli: Satır öğesinin türüne/sektörüne göre 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 gibi rezervasyon siparişleri |
PriceAttribute
Bir siparişin veya satır öğesinin fiyat özelliği.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | ||
---|---|---|
type |
Gerekli: Para özelliği türü. |
|
name |
Gerekli: Fiyat özelliğinin kullanıcı tarafından gösterilen dizesi. Bu numara, satıcı tarafından gönderilir ve yerelleştirilmiş. |
|
id |
İsteğe bağlı: Bu fiyatın karşılık geldiği satır öğesinin kimliği. |
|
state |
Gerekli: Fiyatın durumu: Tahmin ve Gerçek değer. |
|
taxIncluded |
Fiyatın vergi dahil olup olmadığı. |
|
spec alanı. Parasal tutarı veya milisaniye cinsinden yüzdeyi temsil eder. spec şunlardan yalnızca biri olabilir: |
||
amount |
Para tutarı. |
|
amountMillipercentage |
Bir yüzdenin 1/1000'i kadar yüzde spesifikasyonu. Örneğin: %8,750, 8750 olarak, negatif yüzdeler ise indirim yüzdelerini temsil eder. Bu alan kullanımdan kaldırılıyor. Sağlam bir kullanım alanı gerektiğinde tekrar eklemeyi düşünebilirsiniz. |
Tür
Paranın türünü temsil eder.
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 |
Her türlü ek ücret. |
GRATUITY |
Ara toplama eklenecek. |
TOTAL |
Siparişin veya satır öğesinin fiyatı gösteriliyor. |
Eyalet
Fiyat durumunu temsil eder.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmedi. |
ESTIMATE |
Fiyat yalnızca tahminidir ancak nihai tutar bu tutara yakın olur. Örnek: İşlem sırasında verginin doğru bir şekilde bilinmediği durumlarda toplam, ESTIMATE tutarı olur. |
ACTUAL |
Kullanıcı için alınacak gerçek fiyat. |
Para birimi
Para birimi türüyle birlikte para tutarını temsil eder.
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 bir takip işlemi.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Gerekli: İşlem türü. |
title |
Kullanıcıya gösterilen işlemin başlığı veya etiketi. İzin verilen maksimum uzunluk 100 karakterdir. |
openUrlAction |
Gerçekleştirilecek 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üleme işlemi. |
MODIFY |
Sipariş işlemini değiştir. |
CANCEL |
Sipariş işlemini iptal et. |
RETURN |
Siparişi iade etme işlemi. |
EXCHANGE |
Değişim siparişi 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 |
Çağrı işlemi. |
REORDER |
İşlemi yeniden sıralayın. |
REVIEW |
Sipariş işlemini inceleyin. |
CUSTOMER_SERVICE |
Müşteri hizmetleriyle iletişim kurun. |
FIX_ISSUE |
Sorunu düzeltmek için doğrudan 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ı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri |
androidApp |
URL'nin bir Android Uygulaması tarafından karşılanması bekleniyorsa Android Uygulaması ile ilgili bilgiler. |
urlTypeHint |
URL türüyle ilgili bir ipucu gösterir. |
AndroidApp
Sipariş karşılama kısıtlamaları için Android uygulamasının spesifikasyonu
JSON gösterimi | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
Alanlar | |
---|---|
packageName |
Android Fulfillment belirtilirken paket adı belirtilmelidir. |
versions[] |
Birden çok filtre belirtildiğinde, herhangi bir filtre eşleşmesi uygulamayı tetikler. |
VersionFilter
Uygulamanın belirli sürümleri gerekirse VersionFilter dahil edilmelidir.
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 (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 değerlerini belirtmeden bırakın. maxVersion'a kadar tüm sürümleri belirtmek için minVersion öğesini belirtmeden bırakın. minVersion'daki tüm sürümleri belirtmek için maxVersion değerini belirtmeden bırakın. |
UrlTypeHint
Farklı URL ipucu 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 bir 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. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
İfşa etme
Kullanıcıya sunulabilecek bir ü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 verilir. |
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 |
Eklenmesi gereken her bir metin bağlantısı için "{0}" ve "{1}" gibi yer tutucular içeren, görüntülenecek metin. Örnek: "UYARI: Bu ürün sizi Kaliforniya Eyaleti tarafından kansere neden olduğu bilinen kimyasallara maruz bırakabilir. Daha fazla bilgi için {0} adresine gidin." Bu açıklama metni tanıtım amaçlı veya reklam benzeri içerik barındırmamalıdır. |
textLinks[] |
Şablonun yerini alması gereken metin bağlantıları. İlki, şablon dizesinde "{0}", ikincisi ise "{1}" yerine geçer. |
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çıklamanın sunulmasıyla ilgili seçenekler.
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ği Varsayılan olarak, başlangıçta daraltılmış durumdadır. |
PresentationRequirement
Açıklamanın sunulması için gerekenler.
Sıralamalar | |
---|---|
REQUIREMENT_UNSPECIFIED |
Belirtilmemiş gereksinim. Bu ayar açıkça belirtilmemelidir. |
REQUIREMENT_OPTIONAL |
Açıklama isteğe bağlıdır. Cihaz, açıklamaları göstermeyi desteklemiyorsa atlanabilir. |
REQUIREMENT_REQUIRED |
Açıklama gereklidir. Cihaz, ifşaların gösterilmesini desteklemiyorsa görüşme telefona yönlendirilir. |
PurchaseItemExtension
Satın alma sektörünün satır öğesi içerikleri.
JSON gösterimi | |
---|---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Gerekli: Satır öğesi düzeyinde durum. |
userVisibleStatusLabel |
Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir. |
type |
Gerekli: 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 birimlerde öğenin boyutunu belirtir. Birim fiyatı belirlemek için boyut ve etkin fiyat kullanılır. |
returnsInfo |
Bu satır öğesinin bilgilerini döndürür. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyi döndürdüğü bilgileri devralır. |
fulfillmentInfo |
Bu satır öğesi için 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 paylaşılan tüm ekstra alanlar. Not: Bu uzantının kullanılması önerilmez. Kullanım alanlarına/koşullarına bağlı olarak aşağıdakilerden birini göz önünde bulundurun: 1. Diğer kullanım durumları (ör. genel özellikler/işlevsellik) için kullanılabiliyorsa PurchaseItemExtension içinde alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özelse sektör_uzantısı değerini kullanın. Rastgele türde alanlar içeren bir nesne. |
PurchaseStatus
Bir satın alma siparişi 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ı bir anlama gelebilir. BİÇİM siparişi için, yemek hazırlanıyor olabilir. Perakende satışlarında ise öğe paketleniyor olabilir. |
CREATED |
Sipariş oluşturulur. |
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 değişiklik isteğinde bulundu ve entegratör bu değişikliği işliyor. İstek işlendikten sonra sipariş başka bir duruma taşınmalıdır. |
PurchaseType
Satın alma kategorisi.
Sıralamalar | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
Bilinmeyen değer. |
RETAIL |
Buna fiziksel ürünler gibi satın alma işlemleri dahildir. |
FOOD |
Buna yemek siparişi satın alımı dahildir. |
GROCERY |
Market alışverişi. |
MOBILE_RECHARGE |
Ön ödemeli mobil para yükleme satın alma işlemi. |
MerchantUnitMeasure
Satıcı birimi 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) değerine ayarlanırsa dönüşe izin verilir. |
daysToReturn |
Bu süre içinde iade edebilirsiniz. |
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 |
Gerekli: Sipariş karşılamanın türü. |
expectedFulfillmentTime |
Zaman aralığı belirtilmişse aralık veya tek zaman belirtilmişse GMR. Beklenen teslimat veya teslim alma saati. |
expectedPreparationTime |
Zaman aralığı belirtilmişse aralık veya tek zaman belirtilmişse GMR. Yemeğin hazırlanması 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. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
price |
Bu seçeneğin maliyeti. |
fulfillmentContact |
Bu istek karşılama için kullanıcı iletişim bilgileri. |
shippingMethodName |
Kullanıcı tarafından seçilen gönderim yönteminin adı. |
storeCode |
Konumun StoreCode. Örnek: Satıcı olan Walmart, 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 bilgiler. Bu alan yalnızca sipariş karşılama türü PICKUP olduğunda 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 bir etkinlik zamanını temsil eden zaman yapısı.
JSON gösterimi | |
---|---|
{ "timeIso8601": string } |
Alanlar | |
---|---|
timeIso8601 |
Rezervasyon saati, teslimat saati vb. sipariş-etkinlik zamanını temsil eder. Bir süre (başlangıç ve bitiş zamanı), yalnızca tarih, tarih vb. olabilir. Desteklenen tüm biçimler için https://en.wikipedia.org/wiki/ISO_8601 sayfasına bakın. |
PickupInfo
Bir siparişin nasıl teslim alındığıyla ilgili ayrıntılar. Teslim alma türü gibi ayrıntıları ve varsa her türe eklenmiş ek meta verileri içerir.
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[] |
Giriş sürecini desteklemek 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 teslim almak. |
CURBSIDE |
Aracı restoranın dışında belirli bir yere park ettikten sonra oraya yemek teslimatı yapacak birileri var. |
CurbsideInfo
Arabaya teslim alma işlemiyle ilgili ayrıntılar.
JSON gösterimi | |
---|---|
{ "curbsideFulfillmentType": enum ( |
Alanlar | |
---|---|
curbsideFulfillmentType |
İş ortakları, arabaya teslim alma siparişlerini kolaylaştırmak için daha fazla bilgiye ihtiyaç duyar. Seçilen sipariş karşılama türüne bağlı olarak ilgili ayrıntılar kullanıcıdan toplanır. |
userVehicle |
Siparişi 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 alma işlemini kolaylaştırmak için araçla ilgili ayrıntılar gereklidir. |
Araç
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, kullanıcıya gösterilir ve yerelleştirilmelidir. Zorunlu. |
model |
Araç modeli (ör. "Grom"). Bu, kullanıcıya gösterilir ve yerelleştirilmelidir. 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 giriş yöntemini desteklemek için iş ortağı tarafından gerekli olan meta veriler.
JSON gösterimi | |
---|---|
{
"checkInType": enum ( |
Alanlar | |
---|---|
checkInType |
Giriş talimatlarını göndermek için kullanılan yöntem. |
CheckInType
Check-in talimatları gönderilirken çeşitli yöntemler kullanılır.
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. |
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ı. OfferId, Merchant Center'da mevcut değilse yararlıdır. İsteğe bağlı. |
plu |
Genellikle PLU kodları, PLU numaraları, PLU'lar, kod üretme veya etiket üretme olarak adlandırılan fiyat arama kodları, market 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. "Ev > Bakkal > Süt Ürünleri ve Yumurta > Süt > Tam Yağlı Süt" |
productAttributes |
Satıcının ürün hakkında sağladığı ayrıntılar, ör. { "allergen": "peanut" }. OfferId Merchant Center'da mevcut değilse yararlıdır. İsteğe bağlı.
|
ReservationItemExtension
Restoran, saç kesimi gibi rezervasyon siparişleri için satır öğesi içerikleri.
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 bu ayar kaldırılabilir. |
reservationTime |
Hizmetin/etkinliğin gerçekleşmesinin planlandığı zaman. Zaman aralığı, tarih veya kesin tarih saat olabilir. |
userAcceptableTimeRange |
Kullanıcının kabul edebileceği zaman aralığı. |
confirmationCode |
Bu rezervasyonun onay kodu. |
partySize |
Kullanıcı sayısı. |
staffFacilitators[] |
Rezervasyonla ilgili işlemleri yaptıracak personel yöneticileri. Ör. Kuaför. |
location |
Hizmetin/etkinliğin konumu. |
ReservationStatus
Rezervasyon 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 |
Belirtilmemiş tür. |
RESTAURANT |
Restoran rezervasyonu. |
HAIRDRESSER |
Kuaför rezervasyonu. |
StaffFacilitator
Hizmet sağlayıcıyla ilgili bilgiler.
JSON gösterimi | |
---|---|
{
"name": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Personel eğitimini düzenleyen kişinin adı. Ör. "Can Demir" |
image |
Sanatçının resimleri. |
PaymentData
Bir siparişle ilgili ödeme verileri.
JSON gösterimi | |
---|---|
{ "paymentResult": { object ( |
Alanlar | |
---|---|
paymentResult |
Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu. Ödeme deneyimi Actions-on-Google tarafından yönetiliyorsa bu alan Actions on Google tarafından doldurulur. |
paymentInfo |
Kullanıcıyla etkileşim için yararlı olan siparişle ilgili ödeme bilgileri. |
PaymentResult
Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
result alanı. Google ödeme verileri veya satıcı ödeme yöntemi sağlanmış. result şunlardan yalnızca biri olabilir: |
||
googlePaymentData |
Google, ödeme yöntemi verilerini sağlar. Ödeme işleyiciniz şurada Google tarafından desteklenen ödeme işleyici olarak listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla ayrıntı için bağlantı üzerinden ödeme işleyicinize gidin. Aksi takdirde yük ayrıntıları için aşağıdaki belgeleri inceleyin. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Satıcı/İşlem tarafından sağlanan, kullanıcı tarafından seçilen ödeme yöntemi. |
PaymentInfo
Verilen siparişle ilgili ödeme bilgileri. Bu proto, 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önteminin bilgileri. |
paymentMethodProvenance |
İşlem için kullanılan ödeme yönteminin kaynağı. Kullanıcı, aynı ödeme yöntemini hem Google'a hem de satıcıya kaydetmiş olabilir. |
PaymentMethodDisplayInfo
Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.
JSON gösterimi | |
---|---|
{
"paymentType": enum ( |
Alanlar | |
---|---|
paymentType |
Ödemenin türü. |
paymentMethodDisplayName |
Ödeme yönteminin kullanıcı tarafından görünen adı. Örneğin, VISA **** 1234 Check acct **** 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 "sonu beş altı yedi sekizle biten çek hesabı". Not: Bu, yalnızca ses özellikli asistan cihazlarında paymentMethodDisplayName yerine kullanılacak ses açısından optimize edilmiş dizedir. Bu dize ayarlanmazsa paymentMethodDisplayName, kullanıcıya söylenir. |
PaymentType
PaymentType, Satıcı tarafından sağlanan ödeme yöntemi için kullanılan ödeme şeklini belirtir. İşlemde, ödeme yöntemi için görünen ad da sağlanmalıdır.
Sıralamalar | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
Ödeme türü belirtilmedi. |
PAYMENT_CARD |
Kredi/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 nakittir. |
GIFT_CARD |
Ödeme yöntemi hediye kartıdır. |
WALLET |
Üçüncü taraf cüzdan (ör. PayPal) |
PaymentMethodProvenance
İşlem için kullanılan ödeme yöntemi kaynağını temsil eder.
Sıralamalar | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
Kaynak Belirtilmedi. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
Kaynak Google'dır. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
Kaynak 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ığı sürece 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 |
Gerekli: Satın alma türü. |
returnsInfo |
Siparişin iade bilgileri. |
fulfillmentInfo |
Siparişin sipariş karşılama bilgileri. |
purchaseLocationType |
Satın alma işleminin yapıldığı yer (mağazada / internette) |
errors[] |
İsteğe bağlı: Bu siparişin reddedilmesinden kaynaklanan hatalar. |
extension |
Satıcı ile Google arasında paylaşılan tüm ekstra alanlar. Not: Bu uzantının kullanılması önerilmez. Kullanım alanlarına/koşullarına bağlı olarak aşağıdakilerden birini göz önünde bulundurun: 1. Diğer kullanım durumları (ör. genel özellikler/işlevler) için kullanılabiliyorsa PurchaseOrderExtension içinde alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özelse sektör_uzantısı değerini kullanın. Rastgele türde alanlar içeren bir nesne. |
PurchaseLocationType
Satın alma işleminin konum türü.
Sıralamalar | |
---|---|
UNSPECIFIED_LOCATION |
Bilinmeyen değer. |
ONLINE_PURCHASE |
İnternetten satın alınan tüm içerikler. |
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 reddedilmesinin ayrıntılı nedenini temsil eder. |
description |
Ek hata açıklaması. |
entityId |
Hataya karşılık gelen varlık kimliği. Örnek; LineItemId / ItemOptionId'ye karşılık gelebilir. |
updatedPrice |
PRICE_CHANGED / INCORRECT_PRICE hata türüyle alakalıdır. |
availableQuantity |
Şu anda kullanılabilir miktar. AVAILABILITY_CHANGED durumunda geçerlidir. |
ErrorType
Olası hata türleri.
Sıralamalar | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Bilinmeyen hata |
NOT_FOUND |
Varlık bulunamadı. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği gerekiyor. |
INVALID |
Varlık verileri geçerli değil. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği gerekiyor. |
AVAILABILITY_CHANGED |
Öğe mevcut değil veya isteği yerine getirmek için yeterli öğe yok. Varlık kimliği gerekiyor. |
PRICE_CHANGED |
Öğe fiyatı, öğe varlığındaki fiyattan farklı. Varlık kimliği ve güncellenmiş fiyat zorunludur. |
INCORRECT_PRICE |
Ücretlerde fiyat hataları, Toplam. Varlık kimliği ve güncellenmiş fiyat zorunludur. |
REQUIREMENTS_NOT_MET |
Sipariş kabul etmeye ilişkin kısıtlamalar (minimum sepet boyutu vb.) karşılanmadı. |
TOO_LATE |
FulfillmentOption 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ılabilecek ayrıntılı bir hata türü. |
INELIGIBLE |
Kullanıcı sipariş vermeye uygun değil (kara listeye alınmış). |
OUT_OF_SERVICE_AREA |
Sınır kuralları vb. nedeniyle istenen adrese teslimat yapılamıyor. |
CLOSED |
Restoran, sipariş saatinde kapalı. |
PROMO_NOT_APPLICABLE |
Aşağıdakilerin hiçbirinin uymadığı takdirde promosyon kodunun 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 |
Mevcut kullanıcı bu kupon için uygun değil. Promosyon kodunu varlık kimliği olarak ekleyin. |
PROMO_ORDER_INELIGIBLE |
Mevcut sipariş bu kupon için uygun değil. Promosyon kodunu varlık kimliği olarak ekleyin. |
UNAVAILABLE_SLOT |
Öndeki sipariş alanı kullanılamıyor. |
FAILED_PRECONDITION |
Sipariş kabul etmeye ilişkin kısıtlamalar (minimum sepet boyutu vb.) karşılanmadı. |
PAYMENT_DECLINED |
Geçersiz ödeme. |
MERCHANT_UNREACHABLE |
Satıcıya ulaşılamıyor. Bu özellik, iş ortağı toplayıcı olmasına ve satıcıya ulaşamadığında faydalı 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çerikleri
JSON gösterimi | |
---|---|
{
"ticketEvent": {
object ( |
Alanlar | |
---|---|
ticketEvent |
Etkinlik, tüm satır öğesi biletlerine uygulandı. |
TicketEvent
Tek bir etkinliği temsil eder.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Gerekli: Bilet etkinliğinin türü (ör. film, konser). |
name |
Zorunlu: Etkinliğin adı. Örneğin, etkinlik bir filmse, bunun film adı olması gerekir. |
description |
Etkinliğin açıklaması. |
url |
Etkinlik bilgisinin URL'si. |
location |
Etkinliğin gerçekleştiği veya bir kuruluşun bulunduğu konum. |
eventCharacters[] |
Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya aktörleri ya da bir konserin sanatçıları vb. |
startDate |
Başlangıç zamanı. |
endDate |
Bitiş zamanı. |
doorTime |
Giriş saati. Bu saat, etkinliğin başlangıç zamanından farklı olabilir. Örneğin, etkinlik 09:00'da başlıyor ancak giriş saati 08:30'da. |
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. organizatör, sanatçı vb.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Etkinlik karakterinin türü (ör. oyuncu veya yönetmen). |
name |
Karakterin adı. |
image |
Karakterlerin resimleri. |
Tür
Karakter türü.
Sıralamalar | |
---|---|
TYPE_UNKNOWN |
Bilinmeyen tür. |
ACTOR |
İşlemi gerçekleştiren. |
PERFORMER |
Performans sanatçısı. |
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
Bir sonraki yürütülecek sahneyi temsil eder.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Bir sonraki yürütülecek sahnenin adı. |
Oturum
Mevcut sohbet oturumuyla ilgili bilgileri içerir
JSON gösterimi | |
---|---|
{
"id": string,
"params": {
string: value,
...
},
"typeOverrides": [
{
object ( |
Alanlar | |
---|---|
id |
Zorunlu. Mevcut 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. Boş değere sahip parametreler oturumdan kaldırılır. Oturum depolama belgelerine bakın: https://developers.google.com/assistant/conversational/storage-session.
|
typeOverrides[] |
İsteğe bağlı. Oturum kapsamındaki türler. Oturum türü tanımı, mevcut türleri tamamlayabilir veya değiştirebilir. Tür adları benzersiz olmalıdır. |
languageCode |
Mevcut sohbet oturumunun dili. IETF BCP-47 dil kodu olan http://www.rfc-editor.org/rfc/bcp/bcp47.txt'yi izler. İşlemde çok dilli özellikler kullanılıyorsa bu, kullanıcının yerel ayarından farklı olabilir. Örneğin, eller_yanıt.beklenen.dil_kodu değeri ayarlandığında sonraki tüm dönüşler için konuşma dili değiştirilir. Bu değişiklik, 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ştirileceği. |
synonym |
|
TypeOverrideMode
Bir oturum varlık türü için değişiklik 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ımlanmış tür tanımlarının yerini alır. |
TYPE_MERGE |
Bu yanıttaki tür tanımları, daha önce tanımlanmış tür tanımlarıyla birleştirilecek. Yeni tür tanımları, mevcut tür tanımlarının üzerine yazılır. |
SynonymType
Eş anlamlıları olan bir türü temsil eder.
JSON gösterimi | |
---|---|
{
"entries": [
{
object ( |
Alanlar | |
---|---|
entries[] |
Zorunlu. Eş anlamlı kelime türüne ilişkin girişlerin listesi. |
Giriş
Eş anlamlı bir türe ait 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ınması için tekrarlanan eş anlamlılar alanına eklenmesi gerekir. |
synonyms[] |
Zorunlu. Girişin eş anlamlılarının listesi (ör. "bisiklet", "bisiklet"). |
display |
İsteğe bağlı. Öğe görünümü bilgileri. |
EntryDisplay
JSON gösterimi | |
---|---|
{ "title": string, "description": string, "image": { object ( |
Alanlar | |
---|---|
title |
Zorunlu. Öğenin başlığı. Bu metine dokunulduğunda, kullanıcı yazmış gibi, görüşmede aynen geri gönderilir. Koleksiyon öğeleri grubundaki her başlık ve 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ırlık metin. |
openUrl |
Bant öğesine göz atmayla ilişkilendirilen 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 |
İsteği yapan kullanıcının birincil yerel ayarı. IETF BCP-47 dil kodu olan http://www.rfc-editor.org/rfc/bcp/bcp47.txt'yi 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ına bakın: 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 gerçekleştirilen son etkileşimin zaman damgası. Kullanıcı daha önce aracıyla etkileşimde bulunmadıysa bu alan atlanır. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
engagement |
Amaçlara yönelik tüm abonelikler de dahil olmak üzere mevcut 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ının bu İşlem için verdiği izinleri içerir. |
AccountLinkingStatus
Son kullanıcının hesabını bu uygulamaya bağlayıp bağlamadığını belirtir. Hesap bağlama dokümanlarına 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 ileti dizileri genelinde veri kaydedebileceğinizi gösterir.
Sıralamalar | |
---|---|
USER_VERIFICATION_STATUS_UNSPECIFIED |
Bilinmiyor. |
GUEST |
Misafir kullanıcı. |
VERIFIED |
Doğrulanmış kullanıcı. |
Etkileşim
Mevcut kullanıcının hangi etkileşim mekanizmaları için kaydolduğu hakkında ek salt okunur bilgiler sağlar. Örneğin, kullanıcının aynı amaca tekrar abone olmasını istememek için hangi niyete zaten abone olduğunu bilmek yararlı olabilir. Diğer bir deyişle, bu bilgiler yalnızca kullanıcı henüz abone olmadıysa DailyUpdates veya PushBildirimler'i ayarlamak amacıyla bir sahneye koşullu olarak yönlendirilmek için kullanılabilir. Kullanıcı etkileşimi belgelerine bakın: https://developers.google.com/assistant/engagement.
JSON gösterimi | |
---|---|
{ "pushNotificationIntents": [ { object ( |
Alanlar | |
---|---|
pushNotificationIntents[] |
Kullanıcının push bildirimlerini 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'ı açıklar.
JSON gösterimi | |
---|---|
{ "intent": string, "contentTitle": string } |
Alanlar | |
---|---|
intent |
Abone olunan amacın adı. |
contentTitle |
Aboneliğin kısa bir açıklaması. Bildirimin etiketi olarak ve Asistan kullanıcıdan izin istediğinde kullanılır. |
PackageEntitlements
Paket adıyla ilgili kullanıcı haklarının listesi. Dijital iyi işlem belgelerini inceleyin: 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 paketteki yararlanma hakları. |
Hak
Kullanıcının dijital yararlanma hakkı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 ve uygulama içi abonelikler için sunulur. |
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 bulabilirsiniz. |
inAppDataSignature |
Play InApp Faturalandırma API'sindeki getPurchases() yöntemindeki 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 sorun. |
DEVICE_COARSE_LOCATION |
Kullanıcının yaklaşık konumunu, posta kodunu, şehir ve ülke kodunu sorun. |
UPDATE |
Güncelleme göndermek için izin isteyin. https://developers.google.com/assistant/engagement/daily adresine göz atın. |
Ana Sayfa
Kullanıcının hedef cihazının ait olduğu Home Graph yapısını temsil eder.
JSON gösterimi | |
---|---|
{ "params": { string: value, ... } } |
Alanlar | |
---|---|
params |
İsteğe bağlı. Hedef cihazın ait olduğu Home Graph yapısıyla ilişkili parametrelerin listesi. Ev depolama alanı dokümanlarına göz atın: https://developers.google.com/assistant/conversational/storage-home.
|
Cihaz
Kullanıcının Action'a istekte bulunmak için kullandığı cihazı temsil eder.
JSON gösterimi | |
---|---|
{ "capabilities": [ enum ( |
Alanlar | |
---|---|
capabilities[] |
Zorunlu. İşlem için istekte bulunan cihazın ö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 doldurulduğunu unutmayın. Genel veya ayrıntılı izne göre ayarlanan alanlar hakkında daha fazla ayrıntı için konum mesajına bakın. İzin dokümanlarına 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 aracılığıyla 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 ses medyalarını çalabilir. |
INTERACTIVE_CANVAS |
Cihaz, etkileşimli bir tuval yanıtı gösterebilir. |
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, evdeki depolama alanını kaydetmeyi ve getirmeyi 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ı beklenir. Tam konum izni, "administrativeArea" ve "addressLines" gibi ek alanları doldurur. |
TimeZone
IANA Saat Dilimi Veritabanı'ndan alınan bir saat dilimini gösterir.
JSON gösterimi | |
---|---|
{ "id": string, "version": string } |
Alanlar | |
---|---|
id |
IANA Saat Dilimi Veritabanı saat dilimi, ör. "America/New_York". |
version |
İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası, ör. "2019a". |
İçerik
Kullanıcı sorgu yaptığında bağlam bilgilerini içerir. Bunlarla sınırlı olmamak üzere, etkin medya oturumu ve Tuval web uygulamasının durumu gibi bilgiler bu bağlamda değerlendirilir.
JSON gösterimi | |
---|---|
{ "media": { object ( |
Alanlar | |
---|---|
media |
Mevcut etkin medya oturumuyla ilgili bağlam bilgilerini içerir. |
canvas |
Mevcut 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 kesir basamağı içeren ve " |
index |
Medya yanıtındaki medya dosyaları listesindeki geçerli etkin medya dosyasının 0 tabanlı dizini. |
CanvasContext
Mevcut tuvalle ilgili bağlam bilgilerini içerir.
JSON gösterimi | |
---|---|
{ "state": value } |
Alanlar | |
---|---|
state |
İsteğe bağlı. Durum, 3. taraf Etkileşimli Tuval uygulaması tarafından ayarlanır. Bu yalnızca istek için ayarlanır, yanıt için ayarlanmaz. Örneğin, bu bir yemek tarifi uygulamasıysa durum, struct : { "current_page" : 5, "last_page" : 3, } değerinin bir değeri olabilir. Boyut sınırı 50 KB'tır. |
Beklenen
Diyaloğun bir sonraki dönüşü için beklentileri açıklar.
JSON gösterimi | |
---|---|
{ "speech": [ string ] } |
Alanlar | |
---|---|
speech[] |
İşlemin, kullanıcının konuşmaya ağırlık verme için söylediği ifadelerden beklediği ifadelerin listesi. En fazla 1.000 kelime öbeğine izin verilir. Not: Bu alan, v2 API'deki BeklenenInput.speech_biasing_hints ile aynı anlama sahiptir. |