- HTTP isteği
- İstek metni
- Yanıt metni
- İşleyici
- Amaç
- IntentParameterValue
- Sahne
- SlotFillingDurumu
- Yuva
- SlotMode
- SlotDurumu
- İstem
- Basit
- İçerik
- Kart
- Resim
- ImageFill
- Bağlantı
- OpenUrl
- UrlHint
- Tablo
- TabloSütun
- Yatay Hizalama
- TableRow
- TableHücre
- Medya
- Medya Türü
- İsteğe Bağlı Medya Denetimleri
- MediaObject
- Medya Resmi
- Tekrar modu
- Toplama
- CollectionItem
- Liste
- ListItem
- Koleksiyon Göz Atma
- Öğe
- Öneri
- Kanvas
- ContinuousMatchConfig
- Beklenen İfade
- Sipariş Güncellemesi
- Tür
- Sipariş
- Kullanıcı Bilgileri
- Telefon Numarası
- Resim
- Satıcı
- Konum
- EnlB
- PostalAddress
- İçindekiler
- Satır Öğesi
- PriceAttribute
- Tür
- Durum
- Para
- İşlem
- Tür
- OpenUrlAction
- AndroidUygulaması
- SürümFiltresi
- UrlTypeİpucu
- ActionMeta Veri
- Açıklama
- AçıklamaMetni
- TextLink
- AçıklamaSunum Seçenekleri
- Sunma Gereksinimi
- PurchaseItemExtension
- Satın Alma Durumu
- Satın Alma Türü
- MerchantUnitMeasurement
- Birim
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- Tür
- Saat
- PickupInfo
- Teslim Alma Türü
- CurbsideInfo
- CurbsideFulfillmentType
- Araç
- CheckInInfo
- Giriş Türü
- ItemOption
- ProductDetails
- BookingItemExtension
- Rezervasyon Durumu
- RezervasyonTürü
- StaffFacilitator
- Ödeme Verileri
- ÖdemeSonucu
- Ödeme Bilgileri
- PaymentMethodDisplayInfo
- Ödeme Türü
- Ödeme Yöntemi Provenance
- Promosyon
- PurchaseOrderExtension
- Satın Alma Konum Türü
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- Tür
- Eventcharacter
- Tür
- UserNotification
- Sonraki Sahne
- Oturum
- TypeGeçersiz Kılma
- TypeGeçersiz Mod
- SynonymType
- Giriş
- GirişGörüntülü Reklam Ağı
- Kullanıcı
- Hesap Bağlama Durumu
- UserVerificationStatus
- Etkileşim
- IntentSubscription
- PackageEntitlements
- Yararlanma hakkı
- SkuType
- İmzalı Veriler
- İzin
- Ana Sayfa
- Cihaz
- Kapasite
- Konum
- Saat Dilimi
- Bağlam
- MediaContext
- CanvasContext
- Beklenen
fulfillment 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 metni
İ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ğıyla ilgili yerine getirilecek bilgiler. Örneğin, bilgi edinme amacı taşıyan bir isteğin "getFact" adında bir işleyicisi olabilir. |
intent |
Zorunlu. Eşleşen son niyeti gösterir. https://developers.google.com/assistant/conversational/intents adresine göz atın. |
scene |
İsteğe bağlı. İşlevin çağrıldığı geçerli ve sonraki sahneyle ilgili bilgiler. Sipariş karşılama çağrısı bir sahne kapsamında yapıldığında doldurulur. https://developers.google.com/assistant/conversational/events adresine göz atın. |
session |
Zorunlu. Oturum kimliği ve oturum parametreleri gibi oturum verilerini muhafazaya alır. |
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 sayfasına göz atın. |
device |
Zorunlu. Kullanıcının İşlem ile etkileşimde bulunmak için kullandığı cihaz hakkındaki bilgiler. |
context |
İsteğe bağlı. Talebin güncel bağlamıyla ilgili bilgiler. Etkin medya oturumu veya tuval bilgileri dahil ancak bunlarla sınırlı değildir. |
Yanıt metni
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
Bir geliştiricinin karşılamasından Actions on Google'a gönderilen bir 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ıkça daha önce eklenen iletilere eklenir. |
scene |
İsteğe bağlı. Geçerli ve sonraki sahneyi temsil eder. |
session |
İsteğe bağlı. Mevcut oturumla ilgili verileri açıklar, oturum parametreleri sipariş 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 sayfasına göz atın. |
device |
İsteğe bağlı. Kullanıcının erişebildiği Asistan cihazları arasında geçiş yapmak için kullanabilirsiniz. |
expected |
İsteğe bağlı. Sonraki diyalog dönüşüyle ilgili beklentileri açıklar. |
İşleyici
Actions on Google'daki etkinlik bilgilerini sipariş karşılama ile 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, "SiparişArama" gibi bir işleyici adıyla kullanıcının sipariş bilgilerine ulaşmak isteyen bir işleyici kullanılabilir. Diğeri ise "GetProductInfo" gibi bir işleyici adıyla bir veritabanından ürün bilgilerini alabilir.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
İsteğe bağlı. İşleyicinin adı. |
Amaç
Bir 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. Eşleşen son niyetin adı. |
params |
Zorunlu. Amaç eşleştirmenin bir parçası olarak tanımlanan parametreleri gösterir. Bu, tanımlanan parametre adının kullanıcı girişinden tanımlanan parametre değeriyle eşlenir. Tanımlanan eşleşen amaçta tanımlanan tüm parametreler burada gösterilir.
|
query |
İsteğe bağlı. Son kullanıcıdan bu niyetle eşleşen yazılı veya sözlü giriş. Bu değer, kullanıcı girişine göre bir niyet eşleştiğinde doldurulur. |
IntentParametre Değeri
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. Kullanıcı açıklamasından 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 eşleşen parametrede parametre tanımlanmışsa ve parametrenin değeri amaç eşleşmesi sırasında tanımlanabilirse doldurulur. |
Düzen
Bir sahneyi göstermek. Sahneler kullanıcı memnuniyetini arayabilir, istem ekleyebilir ve alan değerlerini toplayabilir. Sahneler, etkinlikler veya niyetler tarafından tetiklenir ve diğer sahnelere geçmek için etkinlikleri ve niyetleri 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 okunur durumdadır. |
slots |
Geçerli sahneyle ilişkilendirilen alanlar. İşleyici yanıtları, istekte gönderilmeyen alanları döndüremez.
|
next |
İsteğe bağlı. Sahnedeki bir sonraki adımda yürütülecek bilgiler. |
SlotDolgu Durumu
Slot doldurmanın mevcut durumunu gösterir.
Sıralamalar | |
---|---|
UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
INITIALIZED |
Alanlar başlatıldı ancak alanlar doldurulmadı. |
COLLECTING |
Slot 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ın modu (gerekli veya isteğe bağlı). Geliştirici tarafından ayarlanabilir. |
status |
Yuvanın durumu. |
value |
Alanın değeri. Yanıttaki bu değerin değiştirilmesi, alan doldurma alanındaki değeri değiştirir. |
updated |
Alan değerinin son dönüşte toplanıp toplanmadığını belirtir. Bu alan salt okunur durumdadır. |
prompt |
İsteğe bağlı. Bu istem, gerekli bir alanı doldurması gerektiğinde kullanıcıya gönderilir. Bu istem, konsolda tanımlanan mevcut istemi geçersiz kılar. Bu alan webhook isteğine dahil değildir. |
SlotModu
Bir alanın modunu temsil eder. Yani zorunlu olup olmadığını gösterir.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
OPTIONAL |
Slot doldurma işleminin tamamlanması için alanın gerekli olmadığını belirtir. |
REQUIRED |
Slot doldurma işleminin tamamlanması için alanın gerekli olduğunu belirtir. |
SlotDurumu
Bir yuvanın durumunu gösterir.
Sıralamalar | |
---|---|
SLOT_UNSPECIFIED |
Kullanım alanı doldurulmadığında yedek değer. |
EMPTY |
Alanda hiçbir değer olmadığını belirtir. Bu durum yanıtı kullanarak değiştirilemez. |
INVALID |
Alan değerinin geçersiz olduğunu belirtir. Bu durum, yanıt üzerinden ayarlanabilir. |
FILLED |
Alanda bir değer olduğunu belirtir. Bu durum yanıtı kullanarak 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 nasıl birleştirileceği modu. "true", önceden tanımlanmış tüm iletileri (ilk ve sonuncu, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan mesajları ekler. "false", bu istemde tanımlanan mesajları önceki yanıtlarda tanımlanan iletilere ekler. Bu alanı "false" (yanlış) olarak bırakırsanız Basit istemler, Öneriler istemi ve Tuval istemi'ndeki (İçerik isteminin bir parçası) bazı alanlara ekleme yapabilirsiniz. İstemde tanımlanırsa içerik ve bağlantı mesajlarının üzerine her zaman 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 içerik. |
lastSimple |
İsteğe bağlı. Son ses ve yalnızca metin yanıtı. |
suggestions[] |
İsteğe bağlı. Kullanıcıya gösterilecek öneriler, her zaman yanıtın sonunda görünür. Kapsayıcı istemindeki "geçersiz kıl" alanı "yanlış" ise bu alanda tanımlanan başlıklar, daha önce tanımlanan 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 uygulamaya veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Açık (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ı İşlem, işlem akışı sırasında siparişi aldıktan sonra bir OrderUpdate ile yanıt verir. Google bunu aldıktan sonra, siparişe ilişkin bu güncellemeyi kaydeder ve başarılı olursa, görüntüleme cihazlarında gönderilen TTS ile birlikte bir makbuz kartı görüntüler. |
Basit
Kullanıcıya gönderilmek üzere basit bir istemi gösterir. 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. Kapsayıcı istemindeki "geçersiz kıl" alanı "doğru" ise 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. Belirtilmezse, yukarıdaki konuşma alanının görüntü oluşturma işlemi kullanılır. 640 karakterle sınırlıdır. Kapsayıcı istemindeki "geçersiz kıl" alanı "doğru" ise bu alanda tanımlanan metin, önceki Basit istemin metniyle değiştirilir. |
İçerik
Zengin istemler veya seçim istemleri için kapsayıcı nesne.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birlik alanı
|
||
card |
Temel kart. |
|
image |
Resim. |
|
table |
Tablo kartı. |
|
media |
Oynatılacak medya grubunu gösteren yanıt. |
|
collection |
Arasından seçim yapabileceğiniz bir dizi seçeneğin gösterildiği kart. |
|
list |
Arasından seçim yapabileceğiniz bir seçenek listesi sunan kart. |
|
collectionBrowse |
Açılan web sayfaları koleksiyonunu gösteren kart. |
Kart
Resim ve/veya metin gibi bazı bilgileri görüntülemek için kullanılan 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 olarak sabitlenir. İsteğe bağlı. |
imageFill |
Resim arka planının nasıl doldurulacağı. İsteğe bağlı. |
button |
Giden bağlantıya sahip 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 görselin 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ı. |
Resim Dolgusu
Resmin sunumunu etkileyen 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 ve resim kapsayıcısı arasındaki boşlukları gri çubuklarla doldurun. |
WHITE |
Resim ve resim kapsayıcısı arasındaki boşlukları beyaz çubuklarla doldurun. |
CROPPED |
Resim, resim genişliği ve yüksekliği kapsayıcı kapsayıcı boyutlarıyla veya bu boyutların üzerinde olacak şekilde ölçeklendirilir. Bu durum, ölçeklenmiş resim yüksekliği kapsayıcı yüksekliğinden büyükse resmin üst ve alt kısmını kırpabilir veya ölçeklendirilmiş resim genişliği kapsayıcı genişliğinden büyükse resmin sol ve sağ taraflarını kırpabilir. Bu, 4:3 oranındaki bir videoyu oynatırken geniş ekran TV'de "Yakınlaştırma Moduna" benzer. |
Bağlantı
İlişkili uygulamaya veya siteye bağlantı verebilecek ek bir öneri çipi. Çip, "Açık (ad)" başlığıyla oluşturulur.
JSON gösterimi | |
---|---|
{
"name": string,
"open": {
object ( |
Alanlar | |
---|---|
name |
Bağlantının adı. Maksimum 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ı: - Uygulama bağlantılı bir uygulamayı veya web sayfasını açmak için kullanılan http/https url'leri |
hint |
URL türü için bir ipucunu gösterir. |
URLİpucu
Farklı türde URL ipuçları.
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 işaret eden URL. https://amp.dev/ adresine bakın. |
Tablo
Bir metin tablosu görüntülemek için kullanılan 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 başlığı. İsteğe bağlı. |
image |
Tabloyla ilişkilendirilmiş resim. İsteğe bağlı. |
columns[] |
Sütunların başlıkları ve 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üzeyde hangi satırların gösterileceğini görmek için lütfen simülatör ile test yapın. WEB_BROWSER özelliğini destekleyen yüzeylerde kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz. |
button |
Düğme. |
TabloSütun
JSON gösterimi | |
---|---|
{
"header": string,
"align": enum ( |
Alanlar | |
---|---|
header |
Sütun için başlık metni. |
align |
w.r.t sütunundaki içeriğin yatay hizalaması. Belirtilmemesi halinde içerik ön kenara hizalanır. |
Yatay Hizalama
Hücredeki içeriğin hizalaması.
Sıralamalar | |
---|---|
UNSPECIFIED |
|
LEADING |
Hücrenin ön ucu. Bu, varsayılan seçenektir. |
CENTER |
İçerik, sütunun ortasına hizalanır. |
TRAILING |
İçerik, sütunun son kenarına hizalanır. |
TabloSatırı
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 bazı hücreler belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi hücrelerin gösterileceğini görmek için lütfen simülatör ile test yapın. |
divider |
Her satırdan sonra bir ayırıcı olup olmadığını belirtir. |
TabloHücresi
Bir satırdaki hücreyi tanımlar.
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 ofsetini başlat. Saniyede en fazla dokuz ondalık basamak içeren ve " |
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 istek üçüncü taraf olarak yapılır. Ayarlanmazsa 3p, iki varsayılan kontrol türünü (FINISHED ve SUCCESS) işlemeye devam etmelidir. |
mediaObjects[] |
Medya Nesnelerinin Listesi |
repeatMode |
Medya Nesneleri listesi için tekrarlama modu. |
firstMediaObjectIndex |
mediaObjects içindeki ilk Medya Nesnesinin oynatılacağı 0 tabanlı dizin. Belirtilmezse sıfır veya sınırların dışındaysa oynatma, mediaObjects içindeki ilk medya nesnesinde başlar. |
MedyaTürü
Bu yanıtın medya türü.
Sıralamalar | |
---|---|
MEDIA_TYPE_UNSPECIFIED |
|
AUDIO |
Ses dosyası. |
MEDIA_STATUS_ACK |
Medya durum raporunu kabul eden yanıt. |
İsteğe Bağlı Medya Denetimleri
Medya yanıtının destekleyebileceği isteğe bağlı medya kontrolü türleri
Sıralamalar | |
---|---|
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED |
Değer belirtilmemiş |
PAUSED |
Duraklatılmış etkinlik. Kullanıcı medyayı duraklattığında tetiklenir. |
STOPPED |
Etkinlik durduruldu. Kullanıcı, medya oynatma sırasında oturumun 3. oturumundan çıktığında tetiklenir. |
MedyaNesnesi
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 bir şekilde bulunmalıdır. Canlı yayın yalnızca MP3 biçiminde desteklenir. |
image |
Medya kartıyla gösterilecek resim. |
MedyaGörüntüsü
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birlik alanı
|
||
large |
Albümün kapağı gibi büyük bir resim. |
|
icon |
Başlıkta, sağ tarafta küçük bir resim simgesi gösteriliyor. 36x36 dp olarak yeniden boyutlandırılır. |
Tekrar Modu
Medya nesnelerinin listesi için tekrarlama modu türleri.
Sıralamalar | |
---|---|
REPEAT_MODE_UNSPECIFIED |
KAPALI değerine karşılık gelir. |
OFF |
Son medya nesnesinin sonundaki medya oturumunu sona erdirin. |
ALL |
Son medya nesnesinin sonuna gelindiğinde ilk medya nesnesinin başlangıcına gidin. |
Koleksiyon
Seçilebilecek seçenekleri içeren 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. En az 2, en fazla 10 olabilir. |
imageFill |
Koleksiyon öğelerinin resim arka planları nasıl doldurulur? İsteğe bağlı. |
KoleksiyonÖğesi
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
Arasından seçim yapabileceğiniz bir seçenek listesi sunan 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 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ı. |
Koleksiyona Göz Atma
Bir grup web dokümanı, büyük parçalardan oluşan bir koleksiyon olarak sunar. Öğeler, ilişkili web dokümanlarının web görüntüleyicide başlatılması için seçilebilir. https://developers.google.com/assistant/conversational/prompts-selection#collectionbrowsing adresini ziyaret edin.
JSON gösterimi | |
---|---|
{ "items": [ { object ( |
Alanlar | |
---|---|
items[] |
Öğe listesi. En az 2, en fazla 10 olabilir. |
imageFill |
Resim görüntüleme seçeneği 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 öğesinin altbilgi metni. Açıklamanın altında gösterilir. Üç satırlık metinle kesilmiş tek satır. |
image |
Koleksiyon öğesinin resmi. |
openUriAction |
Zorunlu. Öğe seçilirse açılacak URI. |
Öneri
Öneriler, Asistan'ın istemi görüntülemesi durumunda, görüntüleme özellikli cihazlarda kullanıcılara öneri çipleri sağlar. Görüşmeye devam etmek veya özet oluşturmak için kullanıcı yanıtlarını belirtmek üzere öneri çiplerini kullanın. Dokunulduğunda, bir öneri çipi gösterilen metni görüşme sırasında olduğu gibi kullanıcı tarafından yazılmış gibi döndürür. https://developers.google.com/assistant/conversational/prompts#suggestions adresini inceleyin
JSON gösterimi | |
---|---|
{ "title": string } |
Alanlar | |
---|---|
title |
Zorunlu. Öneri çipinde gösterilen metin. Bu mesaja dokunulduğunda, kullanıcı yazmış gibi sohbet mesajında tekrar yayınlanır. Her başlık, öneri çipleri grubu arasında 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ını görüntülemenin yanı sıra kapsayıcıda kullanıcı ile konuşma komutu içeren "firstBasit" alanıyla birlikte kullanılabilir. Maksimum yanıt 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 kanvastaki URL yeniden kullanılır. |
data[] |
İsteğe bağlı. Etkinlik olarak etkileyici deneyim web sayfasına aktarılacak JSON verileri. Kapsamdaki istemdeki "geçersiz kıl" alanı "yanlış" ise bu Tuval isteminde tanımlanan veri değerleri, önceki Tuval 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. |
SürekliEşleşme Yapılandırması
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 oturumu sırasında beklenen tüm ifadeler. |
durationSeconds |
Sürekli eşleşme modunu açık tutma süresi. Belirtilirse süre dolduğunda mikrofon kapatılır. İzin verilen maksimum değer 180'dir. |
Beklenen İfade
JSON gösterimi | |
---|---|
{ "phrase": string, "alternativePhrases": [ string ] } |
Alanlar | |
---|---|
phrase |
Sürekli eşleşme modu oturumu sırasında eşleştirilecek ifade. |
alternativePhrases[] |
Konuşma ön yargısı olsa bile bazı ifadeler konuşma modeli tarafından yanlış tanınabilir. Bu, geliştiricilerin eşofmanlar için alternatif tetikleyiciler belirtmesine olanak tanır. |
Sipariş Güncellemesi
Bir siparişe güncelleyin.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_maskeyi kullanın. SNAPSHOT yazarsanız, OrderUpdate.order tüm sipariş olmalıdır. = ORDER_STATUS değeri, sipariş seviyesinde durum değişikliğidir. Yalnızca sipariş.last_update_time ve bu dikey durum bilgisi alınır. Not: type.ORDER_STATUS, yalnızca PurcahaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamını genişletmeyle 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 dikkate alınması gereken bazı noktalar vardır: 1. sipariş isteği.last_update_time, güncelleme isteğinin bir parçası olarak her zaman güncellenecektir. 2. updateMask'ın bir parçası olarak sağlanırsa Order.create_time, Order.google_order_id ve Order.merchant_order_id yok sayılır. Bu, tam nitelikli alanların adlarının virgülle ayrılmış bir listesidir. Örnek: |
userNotification |
Belirtilirse kullanıcıya belirtilen başlığı ve metni içeren bir bildirim gösterir. Bildirim belirtmek, bildirim gönderilmesi için bir öneridir ve sonuç olarak bildirim alacağı garanti edilmez. |
reason |
Değişikliğin/güncellemenin nedeni. |
Tür
Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_maskeyi kullanın. Sipariş için izin verilen güncellemeler.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi. Bu değer açık bir şekilde ayarlanmamalıdır. |
ORDER_STATUS |
Yalnızca siparişin durumu güncellenir. |
SNAPSHOT |
Sipariş anlık görüntüsünü güncelleyin. |
Sırala
Sipariş varlığı. Not: 1. Aksi belirtilmedikçe tüm seviyelerdeki tüm dizeler 1.000 karakterden az olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerde tekrarlanan tüm alanlar 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ıdır 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 farklı, daha kullanıcı dostu bir değer olan userVisibleOrderId olduğunu unutmayın. İzin verilen maksimum uzunluk 128 karakterdir. |
|
userVisibleOrderId |
Mevcut siparişe referans veren kullanıcı kimliği. Bu kimlik; web siteleri, uygulamalar ve e-posta dahil olmak üzere diğer bağlamlarda bu sipariş için gösterilen kimlikle tutarlı olmalıdır. |
|
userVisibleStateLabel |
Kullanımdan kaldırıldı: Bunun yerine OrderExtension 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. Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
|
lastUpdateTime |
Siparişin son güncellendiği tarih ve saat. OrderUpdate için gerekli. Nanosaniye çözünürlükte ve dokuz adede kadar 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 bir sağlayıcıdan farklı olabilir. Örnek: ANA ana sayfasındaki satır öğesiyle Expedia siparişi. |
|
contents |
Gerekli: Satır öğeleri grubu olan sipariş içeriği. |
|
priceAttributes[] |
Fiyat, indirimler, vergiler ve benzer bilgiler. |
|
followUpActions[] |
Sipariş düzeyindeki takip işlemleri. |
|
paymentData |
Siparişle ilgili ödemeyle ilgili veriler. |
|
termsOfServiceUrl |
Sipariş/teklif edilen sipariş için geçerli olan hizmet şartlarının bağlantısı. |
|
note |
Siparişe eklenen notlar. |
|
promotions[] |
Bu siparişle ilişkili tüm promosyonlar. |
|
disclosures[] |
Bu siparişle ilişkili açıklamalar. |
|
vertical |
Kullanımdan kaldırıldı: Bunun yerine temaları 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 sektör, satır öğesi düzeyindeki sektör türüyle eşleşmelidir. Olası değerler: Rastgele tür alanlarını içeren bir nesne. Ek alan ( |
|
Birlik alanı verticals . Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu sektör, satır öğesi düzeyindeki sektör türüyle eşleşmelidir. verticals aşağıdakilerden yalnızca biri olabilir: |
||
purchase |
Satın alma siparişi |
|
ticket |
Bilet siparişi |
UserInfo
Kullanıcı hakkında bilgi. Bir siparişle ilişkili kullanıcının bilgilerini 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. burcinbilgili@gmail.com. |
firstName |
Kullanıcının adı. |
lastName |
Kullanıcının soyadı. |
displayName |
Kullanıcının görünen adı, addan 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) Öneri E.164'te tanımlandığı gibi, E.164 biçiminde telefon numarası. https://en.wikipedia.org/wiki/E.164 |
extension |
Dahili numara, en fazla 40 haneden oluşan bir dizi sayı olarak tanımlanma dışında ITU önerilerinde standartlaştırılmamıştır. Uzantıda baştaki sıfırın kullanılabilmesi için buradaki dize olarak tanımlanır (standart tanımlı olmadığından kuruluşların bunu yapmak için tam özgürlüğü vardır). Rakamlar dışında, "," (beklemeyi belirtir) gibi diğer arama karakterleri de burada bulunabilir. Örneğin, xxx-xxx-xxxx dahili 123 uzantısında "123" uzantısıdır. |
preferredDomesticCarrierCode |
Bu telefon numarasını yurtiçi ararken tercih edilen operatör seçim kodu. Ayrıca, bazı ülkelerde sabit hatlardan cep telefonlarına arama yaparken bazı ülkelerdeki numaraların çevrilmesi gerekir. Örneğin, Kolombiya'da bir cep telefonundan yurt içi sabit telefona arama yaparken numaradan önce "3" aranmalıdır (diğer şekilde) Bunun "tercih edilen" kod olduğunu, 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 görselin 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 için satıcı.
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ı. |
image |
Satıcıyla ilişkili resimdir. |
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. "1600 Amphitheatre Pkwy, Mountain View, CA 94043". [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ı. Örneğin, işletmenin bulunduğu konumun iletişim numarası veya teslimat konumunun telefon numarası. |
notes |
Konumla ilgili notlar. |
placeId |
Yer kimliği, bir yerin ayrıntılarını getirmek için Yerler API'si 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, derece enlemini ve dereceyi boylamı temsil etmek için çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklarda 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). Posta adresi göz önüne alındığında bir posta hizmeti öğeleri bir tesise, posta kutusuna veya benzer bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.
Genelde adres, işlemin türüne bağlı olarak kullanıcı girişi yoluyla veya mevcut verileri içe aktararak oluşturulur.
Adres girişi / düzenlemesi hakkında tavsiye: - https://github.com/google/libaddressinput gibi i18n için hazır bir adres widget'ı kullanın) - Kullanıcılara, bu alanın kullanıldığı ülkelerin dışındaki alanların girişi veya düzenlemesi için kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için lütfen şu adresi ziyaret edin: 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 uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresteki ülkenin/bölgenin CLDR bölge kodu. Bu çıkarım 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/region_information.html adresine göz atın. Örnek: İsviçre için "CH". |
languageCode |
İsteğe bağlı. Bu adrese ait içeriklerin 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 çevirisindeki eşdeğerleriyle eşleşmesi beklenir. Bu durum, bazı ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve biçimlendirmeyi veya biçimlendirmeyle ilgili olmayan diğer işlemleri hiçbir zaman etkilemez. Bu değer bilinmiyorsa unutulmalıdır (yanlış olabilecek bir varsayılan belirtmek yerine). Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Tüm ülkeler posta kodlarının var olmasını zorunlu tutmaz. Ancak bu kodların kullanıldığı yerlerde adresin diğer bölümleriyle birlikte ek doğrulamalar (ör. ABD'de eyalet/posta doğrulaması) tetikleyebilir. |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Çoğu bölgede kullanılmaz. Değer kullanıldığında değer, "CEDEX" gibi bir dize, bunu takip eden bir sayı (ör. "CEDEX 7") veya yalnızca bir sayıdır ve "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malawi) veya "postane göstergesi"ni (ör. Fildişi Sahili) temsil eder. |
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 il olabilir. Özellikle İspanya için bu özerk topluluk değildir (örneğin, "Katalona değil", "Barselona"). Birçok ülke, posta adreslerinde bağlı olduğu bir idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş bırakılmamalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/şehir bölümünü belirtir. Örnekler: ABD şehri, BT komitesi, Birleşik Krallık posta şehri. Şehirlerin iyi tanımlanmadığı veya bu yapıya iyi sığmadığı bölgelerde, semti boş bırakın ve addressLines kullanın. |
sublocality |
İsteğe bağlı. Adresin alt semti. Örneğin bu; mahalleler, ilçeler, mahalleler olabilir. |
addressLines[] |
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines alanındaki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla değer (ör. "Austin, TX") içerebileceğinden 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. Bu özelliğin değişebileceği yerlerde (ör. Japonya), adresi göstermek için address_language [ör. büyük veya küçük siparişlerde "ja", küçükten büyüğe "ja-Latn" veya "en") kullanılır. Bu şekilde, adrese göre en spesifik satır dili dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, adres satırlarında kalan tüm bilgilerin bulunduğu bir regionCode'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ülmeden adres bileşenlerinin hiçbiriyle ilgili anlamsal gerekçeler sağlanamaz. Yalnızca regionCode ve addressLines içeren bir adres oluşturmak, ardından yapılandırılmamış adreslerin işlenmesi için önerilen adres coğrafi kodlamadır (adresin hangi bölümlerinin semt veya bağlı bölge 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, video "sağlık" 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 zorunludur ve en fazla 50 satıra izin verilir. Tüm satır öğeleri aynı sektöre ait olmalıdır. |
Satır Öğesi
Bir satır öğesi bir sektör içeriyor. Bir sipariş veya alışveriş sepetinde aynı sektörde birden fazla satır öğesi bulunabilir. Alt satır öğeleri/eklentiler, kullanım alanlarına göre dikey protolarda tanımlanmalıdır. Not: 1. Aksi belirtilmedikçe tüm seviyelerdeki tüm dizeler 1.000 karakterden az olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerde tekrarlanan tüm alanlar 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 PurchaseOrderExtension.status özelliğini 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ı ANA ile Expedia siparişi. |
|
priceAttributes[] |
Satır öğesi düzeyinde fiyat ve ayarlamalar. |
|
followUpActions[] |
Satır öğesinde 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 kullanıcısı adına restoran rezervasyonu yaptı. |
|
image |
Varsa bu öğeyle ilişkili küçük resim. |
|
description |
Satır öğesi açıklaması. |
|
notes[] |
Belirli bir satır öğesi için geçerli olan ek notlar (ör. iptal politikası). |
|
disclosures[] |
Bu satır öğesiyle ilişkili açıklamalar. |
|
vertical |
Kullanımdan kaldırıldı: Bunun yerine temaları kullanın. Gerekli: Satır öğesinin türüne/sektörüne göre Semantik İçeriği. Her tema kendi sipariş karşılama ayrıntılarını içermelidir. Şu değerlerden biri olmalıdır: Rastgele tür alanlarını içeren bir nesne. Ek alan ( |
|
Birlik alanı verticals . Gerekli: Satır öğesinin türüne/sektörüne göre Semantik İçeriği. Her tema kendi sipariş karşılama ayrıntılarını içermelidir. verticals aşağıdakilerden yalnızca biri olabilir: |
||
purchase |
Ürün, gıda vb. satın alma işlemleri. |
|
reservation |
Restoran, saç kesimi vb. rezervasyon siparişleri |
PriceAttribute (Fiyat Özelliği)
Bir siparişin veya satır öğesinin fiyat özelliği.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | ||
---|---|---|
type |
Gerekli: Para türü özelliği. |
|
name |
Gerekli: Fiyat özelliğinin kullanıcı tarafından görüntülenen dizesi. Bu bilgiler 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 |
Zorunlu: Fiyatın durumu: Tahmini ve Gerçek fiyat karşılaştırması. |
|
taxIncluded |
Fiyatın vergi dahil olup olmadığı. |
|
Birlik alanı spec . Para tutarını veya milisaniye yüzdesini gösterir. spec aşağıdakilerden yalnızca biri olabilir: |
||
amount |
Para tutarı. |
|
amountMillipercentage |
Yüzde spesifikasyonunun yüzde 1/1000'ine oranı. Örneğin, %8,750 %8750 olarak, negatif yüzdeler ise yüzdelik indirimleri ifade eder. Bu alan kullanımdan kaldırılıyor. Katı kullanım alanı gerekli olduğunda tekrar ekleyebilirsiniz. |
Tür
Para türünü gösterir.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi. İstemciler bunu açıkça belirtmek zorunda kalmamalıdır. |
REGULAR |
İndirimler uygulanmadan önceki normal görüntüleme fiyatı. |
DISCOUNT |
Alt toplamdan çıkarılacak. |
TAX |
Alt toplama eklenecek. |
DELIVERY |
Alt toplama eklenecek. |
SUBTOTAL |
Bazı ücretler eklenmeden önceki alt toplam. |
FEE |
Ek Ücret. |
GRATUITY |
Alt toplama eklenecek. |
TOTAL |
Siparişin veya satır öğesinin fiyatı gösteriliyor. |
Eyalet
Fiyat durumunu gösterir.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmedi. |
ESTIMATE |
Fiyat yalnızca bir tahmindir, ancak nihai tutar bu tutara yakın olacaktır. Örnek: İşlem sırasında verginin doğru şekilde bilinmediği durumlarda toplam tutar ESTIMATE tutarında olur. |
ACTUAL |
Kullanıcıdan alınacak gerçek fiyat. |
Money
Para birimi türüyle 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 TL olarak 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 |
Yapılması gerekenler. |
actionMetadata |
Bir işlemle ilişkilendirilen meta veriler. |
Tür
Olası takip işlemleri.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Belirtilmemiş işlem. |
VIEW_DETAILS |
Sipariş ayrıntıları işlemini görüntüleyin. |
MODIFY |
Sipariş işlemini değiştirin. |
CANCEL |
Sipariş işlemini iptal edin. |
RETURN |
İade sırası işlemi. |
EXCHANGE |
Exchange sipariş işlemi. |
EMAIL |
E-posta işlemi. EMAIL ve CALL türleri kullanımdan kaldırılmıştır. openUrlAction.url, telefon numarası veya e-posta olarak kullanılabilir. |
CALL |
Telefon araması işlemi. |
REORDER |
İşlemi yeniden sırala. |
REVIEW |
Sipariş işlemini inceleyin. |
CUSTOMER_SERVICE |
Müşteri hizmetleriyle iletişime geçin. |
FIX_ISSUE |
Sorunu gidermek için satıcı sitesine veya uygulamasına gidin. |
DIRECTION |
Yol tarifi bağlantısı. |
OpenUrlİşlemi
Belirtilen URL'yi açar.
JSON gösterimi | |
---|---|
{ "url": string, "androidApp": { object ( |
Alanlar | |
---|---|
url |
Şunlardan herhangi biri olabilecek URL alanı: - Uygulama bağlantılı bir uygulamayı veya web sayfasını açmak için kullanılan http/https url'leri |
androidApp |
URL'nin bir Android uygulaması tarafından doldurulmasının beklendiği durumlarda Android uygulamasıyla ilgili bilgiler. |
urlTypeHint |
URL türü için bir ipucunu gösterir. |
Android Uygulaması
Sipariş karşılama kısıtlamaları için Android uygulamasının spesifikasyonu
JSON gösterimi | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
Alanlar | |
---|---|
packageName |
Paket adı, Android yerine getirme belirtilirken paket adı belirtilmelidir. |
versions[] |
Birden fazla filtre belirtildiğinde, herhangi bir filtre eşleşmesi uygulamayı tetikler. |
SürümFiltresi
Uygulamanın belirli sürümleri gerekliyse EditionFiltre dahil edilmelidir.
JSON gösterimi | |
---|---|
{ "minVersion": integer, "maxVersion": integer } |
Alanlar | |
---|---|
minVersion |
Min. sürüm kodu veya 0 (dahil). |
maxVersion |
Maksimum sürüm kodu (dahil). Değer, [minVersion:maxVersion] şeklindedir. Boş aralık, tüm sürümleri ifade eder. Ö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ğerini belirtmeden bırakın. maxVersion sürümüne kadar tüm sürümleri belirtmek için minVersion değerini belirtmeden bırakın. minVersion'daki tüm sürümleri belirtmek için maxVersion'ı belirtilmemiş olarak bırakın. |
URLTürİpucu
Farklı türde URL ipuçları.
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 işaret eden URL. |
İşlemMeta verisi
İşlem başına ilgili meta veri.
JSON gösterimi | |
---|---|
{ "expireTime": string } |
Alanlar | |
---|---|
expireTime |
Bu işlemin sona ereceği zaman. Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
Açıklama
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çıklamanın sunu seçenekleri. |
AçıklamaMetni
Web bağlantılarını içeren bir düz 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österilecek metin. Örnek: "UYARI: Bu ürün sizi, Kaliforniya Eyaleti'nin kansere neden olduğu bilinen kimyasallara maruz bırakabilir. Daha fazla bilgi için {0} adresine gidin." Bu açıklama metni, tanıtım veya reklam benzeri içerik barındırmamalıdır. |
textLinks[] |
Şablona değiştirilecek olan metin bağlantıları. Bunlardan ilki şablon dizesinde "{0}", ikincisi ise "{1}" vb. ile değiştirilir. |
Metin Bağlantısı
Şablona değiştirilmesi 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önlendirileceği URL. |
AçıklamaSunum Seçenekleri
Açıklamanın sunulmasına ilişkin seçenekler.
JSON gösterimi | |
---|---|
{
"presentationRequirement": enum ( |
Alanlar | |
---|---|
presentationRequirement |
Açıklamanın sunuluş şartı. |
initiallyExpanded |
Açıklama içeriğinin başlangıçta genişletilip genişletilmeyeceğini belirtir. Varsayılan olarak, başlangıçta daraltılmış durumdadır. |
Sunu Gereksinimi
Açıklamanın sunulmasıyla ilgili koşul.
Sıralamalar | |
---|---|
REQUIREMENT_UNSPECIFIED |
Belirtilmemiş koşul. Bu ayar açık bir şekilde ayarlanmamalıdır. |
REQUIREMENT_OPTIONAL |
Açıklama isteğe bağlıdır. Cihaz, açıklamaların gösterilmesini desteklemiyorsa bu mesaj atlanabilir. |
REQUIREMENT_REQUIRED |
Açıklama gerekli. Cihaz, açıklamaların gösterilmesini desteklemiyorsa telefon üzerinden görüşme yapılır. |
Satın AlmaÖğe Uzantısı
Satın Alma Sektörünün satır öğesi içerikleri.
JSON gösterimi | |
---|---|
{ "status": enum ( |
Alanlar | |
---|---|
status |
Zorunlu: 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 |
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çümü. Öğenin seçilen birimlerdeki boyutunu belirtir. Birim fiyatı belirlemek için etkin fiyatla birlikte boyut kullanılır. |
returnsInfo |
Bu satır öğesinin bilgilerini döndürür. Ayarlanmazsa bu satır öğesi, sipariş seviyesinde iade bilgilerini devralır. |
fulfillmentInfo |
Bu satır öğesi için sipariş karşılama bilgileri. Politika ayarlanmadan bırakılırsa bu satır öğesi, sipariş düzeyindeki 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 yapılan fazladan alanlar. Not: Bu uzantının kullanılması kesinlikle önerilmez. Kullanım alanına/durumlara bağlı olarak aşağıdakilerden birini değerlendirin: 1. Diğer kullanım alanlarında (ör. genel yetenek/işlev) kullanılabiliyorsa PurchaseItemExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension kullanın. Rastgele tür alanlarını içeren bir nesne. Ek alan ( |
Satın Alma Durumu
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 alınmaya hazır. |
SHIPPED |
Gönderildi. |
DELIVERED |
Teslim edildi. |
OUT_OF_STOCK |
Stokta yok. |
IN_PREPARATION |
"IN_PREPARATION", farklı bağlamda farklı anlamlara gelebilir. YİYECEK sipariş yemek için hazırlanıyor olabilir. Perakende için bir öğenin paketlenmesi 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 değişiklik isteğinde bulundu ve entegratör bu değişikliği işliyor. Sipariş, istek işlendikten sonra başka bir duruma taşınmalıdır. |
Satın Alma Türü
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 |
Yemek siparişi satın alma buna dahildir. |
GROCERY |
Market alışverişi. |
MOBILE_RECHARGE |
Ön ödemeli mobil para yükleme satın alma. |
MerchantUnitmeasure
Satıcı birimi fiyatlandırma ölçüsü.
JSON gösterimi | |
---|---|
{
"measure": number,
"unit": enum ( |
Alanlar | |
---|---|
measure |
Değer: 1.2 örneği. |
unit |
Birim: Örnek POUND, GRAM. |
Birim
Sıralamalar | |
---|---|
UNIT_UNSPECIFIED |
Birim belirtilmedi. |
MILLIGRAM |
Miligram. |
GRAM |
Gram |
KILOGRAM |
Kilogram. |
OUNCE |
Aa. |
POUND |
Kare işareti |
Satın Alma İadeleri Bilgisi
Bir siparişle veya belirli bir satır öğesiyle ilişkili bilgileri döndürür.
JSON gösterimi | |
---|---|
{ "isReturnable": boolean, "daysToReturn": integer, "policyUrl": string } |
Alanlar | |
---|---|
isReturnable |
Doğruysa dönüşe izin verilir. |
daysToReturn |
İade işlemlerini bu kadar gün içinde yapabilirsiniz. |
policyUrl |
İade politikasına bağlantı. |
Satın Alma Siparişi Bilgileri
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ği için benzersiz tanımlayıcı. |
fulfillmentType |
Gerekli: Sipariş karşılama türü. |
expectedFulfillmentTime |
Zaman aralığı belirtilmişse pencere, tek saat belirtilmişse GMR. Beklenen teslimat veya teslim alma süresi. |
expectedPreparationTime |
Zaman aralığı belirtilmişse pencere, tek saat belirtilmişse GMR. Yemeği hazırlamak için beklenen süre. Tek seferlik tercih edilir. |
location |
Teslim alma veya teslimat konumu. |
expireTime |
Bu sipariş karşılama seçeneğinin geçerlilik süresi. Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
price |
Bu seçeneğin maliyeti. |
fulfillmentContact |
Bu sipariş için 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ıdır ve storeCode, sipariş karşılama işleminin gerçekleştirildiğ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 geçerli olur. |
Tür
Sipariş karşılama türü.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Tür belirtilmedi. |
DELIVERY |
Bu sipariş teslim edilecek. |
PICKUP |
Bu siparişin alınması gerekiyor. |
Zaman
Kullanıcıya bir siparişi gösterirken kullanılacak etkinlik zamanını temsil eden zaman yapısı.
JSON gösterimi | |
---|---|
{ "timeIso8601": string } |
Alanlar | |
---|---|
timeIso8601 |
Rezervasyon zamanı, teslimat süresi gibi bir sipariş etkinliği zamanını temsil eder. Süre (başlangıç ve bitiş zamanı), yalnızca tarih, tarih saati vb. olabilir. Desteklenen tüm biçimler için https://en.wikipedia.org/wiki/ISO_8601 adresine bakın. |
Teslim Alma Bilgisi
Bir siparişin nasıl alındığıyla ilgili ayrıntılar. Bu sayfada teslim alma türü ve varsa her türün ek meta verileri gibi ayrıntılar yer alır.
JSON gösterimi | |
---|---|
{ "pickupType": enum ( |
Alanlar | |
---|---|
pickupType |
Teslim alma yöntemi (ör. MAĞAZA, CURBSIDE vb.) |
curbsideInfo |
Arabayla teslim alma bilgilerine özgü ayrıntılar. pickupType "CURBSIDE" değilse bu alan yok sayılır. |
checkInInfo[] |
Girişi desteklemek için iş ortağı tarafından desteklenen çeşitli yöntemlerin listesi. |
Teslim Alma Türü
Desteklenen teslim alma türlerinin listesi.
Sıralamalar | |
---|---|
UNSPECIFIED |
Teslim alma türü belirtilmedi. |
INSTORE |
Restoranın içinden yiyecek alın. |
CURBSIDE |
Aracı, restoranın dışında yer alan belirli bir alana park eden bir kişi, orada yemek teslimatı yapar. |
Araba Yolu Bilgisi
Arabaya teslim almanın nasıl kolaylaştırılacağıyla ilgili ayrıntılar.
JSON gösterimi | |
---|---|
{ "curbsideFulfillmentType": enum ( |
Alanlar | |
---|---|
curbsideFulfillmentType |
İş ortakları, arabaya teslim alma siparişlerini kolaylaştırmak için ek bilgilere ihtiyaç duyar. Hangi sipariş karşılama türünün seçildiğine bağlı olarak kullanıcıdan ilgili bilgiler toplanır. |
userVehicle |
Siparişi veren kullanıcının araç ayrıntıları. |
Arabaya Teslim AlmaTürü
Arabaya teslim alma türlerinin olası değerleri.
Sıralamalar | |
---|---|
UNSPECIFIED |
Arabaya teslim alma türü belirtilmemiş. |
VEHICLE_DETAIL |
Arabaya teslim almayı kolaylaştırmak için araç ayrıntıları gerekiyor. |
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 ad kullanıcıya gösterilir ve yerelleştirilmelidir. Zorunlu. |
model |
Araç modeli (ör. "Grom"). Bu ad kullanıcıya gösterilir ve yerelleştirilmelidir. Zorunlu. |
licensePlate |
Araç plaka numarası (ör. "1ABC234"). Zorunlu. |
colorName |
Araç renk 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. Bir jpg veya png olmalıdır. İsteğe bağlı. |
GirişBilgileri
İş ortağının bir giriş yöntemini desteklemesi için gereken 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 |
Check-in bilgileri e-postayla gönderilir. |
SMS |
Giriş bilgileri SMS ile gönderilir. |
ÖğeSeçeneği
Eklentileri veya alt öğeleri temsil eder.
JSON gösterimi | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
Alanlar | |
---|---|
id |
Öğe seçeneği olarak benzersiz öğe kimliğini girin. |
name |
Seçenek adı. |
prices[] |
Seçenek toplam fiyatı. |
note |
Seçenekle ilgili not. |
quantity |
Öğe seçeneği olan 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. |
Ürün Ayrıntıları
Ü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. Teklif kimliği Merchant Center'da yoksa yararlıdır. İsteğe bağlı. |
plu |
Çoğunlukla PLU kodları, PLU numaraları, PLU'lar, ürün kodları veya gıda etiketleri olarak adlandırılan fiyat arama kodları, marketler ve süpermarketlerde satılan toplu mahsulleri benzersiz şekilde tanımlayan bir numara sistemidir. |
productType |
Satıcı tarafından tanımlanan ürün kategorisi. Ör. "Ana Sayfa > Market > Süt Ürünleri ve Yumurta > Süt > Tam Yağlı Süt" |
productAttributes |
Ürünle ilgili satıcı tarafından sağlanan ayrıntılar, ör. { "allergen": "fıstık" }. Merchant Center'da teklif kimliği yoksa yararlıdır. İsteğe bağlı.
|
RezervasyonÖğeUzantısı
Restoran ve 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 ayarlanmış olmayabilir. |
reservationTime |
Hizmetin/etkinliğin gerçekleşmesi planlanan zaman. Bir tarih aralığı, tarih veya tam tarih olabilir. |
userAcceptableTimeRange |
Kullanıcının kabul edebileceği zaman aralığı. |
confirmationCode |
Bu rezervasyonun onay kodu. |
partySize |
Kullanıcı sayısı. |
staffFacilitators[] |
Rezervasyona yardımcı olacak personel yardımcıları. Ör. Kuaför. |
location |
Hizmetin/etkinliğin konumu. |
Rezervasyon Durumu
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 gerçekleşiyor. |
CHANGE_REQUESTED |
Rezervasyon değişikliği istendi |
REJECTED |
Rezervasyonun süresi doldu veya entegrasyon iş ortağı tarafından reddedildi. |
Rezervasyon Türü
Rezervasyon türü.
Sıralamalar | |
---|---|
RESERVATION_TYPE_UNSPECIFIED |
Belirtilmemiş tür. |
RESTAURANT |
Restoran rezervasyonu. |
HAIRDRESSER |
Kuaför rezervasyonu. |
Personel-Eğitimci
Hizmet sorumlusuyla ilgili bilgiler.
JSON gösterimi | |
---|---|
{
"name": string,
"image": {
object ( |
Alanlar | |
---|---|
name |
Personelin eğitmeni adı. Ör. "Cem Demir" |
image |
Sanatçının resimleri. |
Ödeme Verileri
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'da yönetiliyorsa bu alan, Actions on Google tarafından doldurulur. |
paymentInfo |
Kullanıcının etkileşime girdiği sayfayla ilgili ödeme bilgileri. |
ÖdemeSonuçu
Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.
JSON gösterimi | |
---|---|
{ // Union field |
Alanlar | ||
---|---|---|
Birlik alanı result . Google ödeme verileri veya satıcı ödeme yöntemi sağlanmış. result aşağıdakilerden yalnızca biri olabilir: |
||
googlePaymentData |
Google, ödeme yöntemi verilerini sağladı. Ödeme işleyiciniz Google tarafından desteklenen ödeme işleyici olarak burada listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla bilgi için bağlantıyı tıklayarak ödeme işleyicinize gidin. Aksi takdirde, yük ayrıntıları için aşağıdaki belgelere göz atın. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Kullanıcı tarafından seçilen Satıcı/İşlem tarafından sağlanan ödeme yöntemi. |
Ödeme Bilgileri
Yapılan siparişle ilgili ödeme bilgileri. Bu proto, kullanıcıya yönelik etkileşim için faydalı olan bilgileri yakalar.
JSON gösterimi | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Alanlar | |
---|---|
paymentMethodDisplayInfo |
İşlem için kullanılan ödeme yönteminin görünen bilgileri. |
paymentMethodProvenance |
İşlem için kullanılan ödeme yönteminin kanıtı Kullanıcı hem google hem de satıcıda aynı ödeme yöntemini kaydetmiş olabilir. |
Ödeme YöntemiGörüntüleme Bilgileri
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ülebilen adı. Örneğin, VISA **** 1234 **** 5678 numaralı hesabı kontrol etme |
paymentMethodVoiceName |
Yalnızca ses kullanan Asistan cihazları için kullanıcıya seslenecek ödeme yöntemi adı. Örneğin, "Bir iki iki elli dört ile biten vize" veya "beş altı sekiz sekizle biten vadesiz hesap". Not: Bu, yalnızca ses özellikli Asistan cihazlar için paymentMethodDisplayName yerine kullanılacak olan, ses için optimize edilmiş dizedir. Bu dize ayarlanmazsa bunun yerine paymentMethodDisplayName kullanıcıya okunur. |
Ödeme Türü
PaymentType, satıcı tarafından sağlanan ödeme yöntemi için kullanılan ödeme şeklini belirtir. İşlem ayrıca ödeme yöntemi için bir görünen ad sağlamalıdır.
Sıralamalar | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
Belirtilmemiş ödeme türü. |
PAYMENT_CARD |
Kredi/banka 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 bir hediye kartıdır. |
WALLET |
Üçüncü taraf cüzdanı (ör. Paypal) |
Ödeme YöntemiProvenance
İşlem için kullanılan Ödeme yöntemi kaynağını gösterir.
Sıralamalar | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
Kaynak belirtilmedi. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
Kaynak Google'dır. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
Kaynağın kaynağı Satıcı'dır. |
Tanıtım
Alışveriş sepetine eklenen promosyonlar/teklifler.
JSON gösterimi | |
---|---|
{ "coupon": string } |
Alanlar | |
---|---|
coupon |
Gerekli: Bu teklife kupon kodu uygulandı. |
Satın Alma Siparişi Uzantısı
Sektör/tema 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şin genel durumu. |
userVisibleStatusLabel |
Durum için kullanıcıya görünen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir. |
type |
Gerekli: Satın alma türü. |
returnsInfo |
Siparişle ilgili iade bilgileri. |
fulfillmentInfo |
Siparişle ilgili sipariş karşılama bilgileri. |
purchaseLocationType |
Satın alma işleminin yapıldığı yer (mağazada / çevrimiçi) |
errors[] |
İsteğe bağlı: Bu siparişin reddedilmesinden kaynaklanan hatalar. |
extension |
Satıcı ile Google arasında yapılan fazladan alanlar. Not: Bu uzantının kullanılması kesinlikle önerilmez. Kullanım alanına/durumlara bağlı olarak aşağıdakilerden birini değerlendirin: 1. Diğer kullanım alanları için (ör. genel yetenek/işlev) kullanılabiliyorsa PurchaseOrderExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension kullanın. Rastgele tür alanlarını içeren bir nesne. Ek alan ( |
Satın Alma Konum Türü
Satın alma işleminin konum türü.
Sıralamalar | |
---|---|
UNSPECIFIED_LOCATION |
Bilinmeyen değer. |
ONLINE_PURCHASE |
Tüm satın alma işlemleri internetten satın alındı. |
INSTORE_PURCHASE |
Tüm mağaza içi satın alma işlemleri. |
Satın Alma Hatası
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 |
Hatayla ilgili ek açıklama. |
entityId |
Hataya karşılık gelen Varlık Kimliği. Buna örnek olarak LineItemId / ItemOptionId verilebilir. |
updatedPrice |
PRICE_CHANGED / INCORRECT_PRICE hata türü için geçerlidir. |
availableQuantity |
Şu anda mevcut olan miktar. AVAILABILITY_CHANGED durumunda geçerlidir. |
Hata Türü
Olası hata türleri.
Sıralamalar | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Bilinmeyen hata |
NOT_FOUND |
Öğe bulunamadı. Öğe, Sipariş Karşılama Seçeneği, Promosyon olabilir. Varlık kimliği gerekiyor. |
INVALID |
Öğe verileri geçerli değil. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği gerekiyor. |
AVAILABILITY_CHANGED |
Öğe kullanılamıyor 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 gerekiyor. |
INCORRECT_PRICE |
Ücretler'deki fiyat hataları, Toplam. Varlık kimliği ve güncellenmiş fiyat gerekiyor. |
REQUIREMENTS_NOT_MET |
Sipariş kabul etmeyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.). |
TOO_LATE |
FulfillmentOption alanının süresi doldu. |
NO_CAPACITY |
Kullanılabilir hizmet kapasitesi yok. Daha ayrıntılı hata türlerinin 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ı hata türü. |
INELIGIBLE |
Kullanıcı sipariş vermeye uygun değil (kara listeye eklenmiş). |
OUT_OF_SERVICE_AREA |
Sınır kuralları vb. nedeniyle istenen adrese teslimat yapılamıyor. |
CLOSED |
Restoran işletme nedeniyle sipariş tarihinde kapalıdır. |
PROMO_NOT_APPLICABLE |
Aşağıdakilerin hiçbirinin geçerli olmadığı durumlarda promosyon kodu uygulanamadığında tüm yakalanan genel hata kodu. Varlık kimliği olarak promosyon kodunu ekleyin. |
PROMO_NOT_RECOGNIZED |
Kupon kodu iş ortağı tarafından tanınmadı. Varlık kimliği olarak promosyon kodunu ekleyin. |
PROMO_EXPIRED |
Promosyonun süresi dolduğundan başvuru yapılamadı. Varlık kimliği olarak promosyon kodunu ekleyin. |
PROMO_USER_INELIGIBLE |
Geçerli kullanıcı bu kupon için uygun değil. Varlık kimliği olarak promosyon kodunu ekleyin. |
PROMO_ORDER_INELIGIBLE |
Geçerli sipariş bu kupon için uygun değil. Varlık kimliği olarak promosyon kodunu ekleyin. |
UNAVAILABLE_SLOT |
Önceden sipariş alanı kullanılamıyor. |
FAILED_PRECONDITION |
Sipariş kabul etmeyle 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ğı toplayıcıysa ve satıcıya ulaşamadığında yardımcı olur. |
ACCOUNT_LINKING_FAILED |
Satıcı, kullanıcının Google hesabını kendi sistemindeki bir hesaba bağlamayı denedi ancak bunu yaparken bir hatayla karşılaştı. |
BiletSiparişi Uzantısı
Film, spor gibi bilet siparişlerinin sipariş içerikleri.
JSON gösterimi | |
---|---|
{
"ticketEvent": {
object ( |
Alanlar | |
---|---|
ticketEvent |
Etkinlik tüm satır öğesi biletlerine uygulandı. |
Etkinlik Etkinliği
Tek bir etkinliği temsil eder.
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Gerekli: Bilet etkinliğinin türü (ör. film, konser). |
name |
Gerekli: Etkinliğin adı. Örneğin, etkinlik bir filmse bunun film adı olmalıdır. |
description |
Etkinliğin açıklaması. |
url |
Etkinlik bilgilerinin URL'si. |
location |
Etkinliğin gerçekleştiği veya kuruluşun bulunduğu konum. |
eventCharacters[] |
Bu etkinlikle ilgili karakterler. Bu, bir film etkinliğinin direktörleri veya aktörleri ya da bir konserin performansı gerçekleştirenler vb. olabilir. |
startDate |
Başlangıç zamanı. |
endDate |
Bitiş zamanı. |
doorTime |
Giriş saati, etkinlik başlangıç zamanından farklı olabilir. Örneğin, etkinlik 09:00'da başlar, ancak giriş saati 08:30'da olur. |
Tür
Etkinliğin türü.
Sıralamalar | |
---|---|
EVENT_TYPE_UNKNOWN |
Bilinmeyen etkinlik türü. |
MOVIE |
Film. |
CONCERT |
Konser. |
SPORTS |
Spor. |
EtkinlikKarakteri
Tek bir etkinlik karakteri (ör. düzenleyen, performans gösteren vb.)
JSON gösterimi | |
---|---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Etkinlik karakterinin türü (ör. aktör veya yönetmen). |
name |
Karakterin adı. |
image |
Karakterin resimleri. |
Tür
Karakter türü.
Sıralamalar | |
---|---|
TYPE_UNKNOWN |
Bilinmeyen tür. |
ACTOR |
Aktör. |
PERFORMER |
Sanatçı. |
DIRECTOR |
Yönetmen. |
ORGANIZER |
Düzenleyen. |
Kullanıcı Bildirimi
Sipariş güncellemesinin bir parçası olarak görüntülenecek 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. |
Sonraki Sahne
Sonraki yürütülecek sahneyi temsil eder.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Sonraki yürütülecek sahnenin adı. |
Oturum
Mevcut görüşme oturumuyla ilgili bilgileri içerir
JSON gösterimi | |
---|---|
{
"id": string,
"params": {
string: value,
...
},
"typeOverrides": [
{
object ( |
Alanlar | |
---|---|
id |
Zorunlu. Geçerli görüşme oturumunun genel olarak benzersiz kimliği. Bu alan salt okunur durumdadır. |
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 zaten tanımlanmış olan parametrelerle birleştirilir. Boş değerli parametreler oturumdan kaldırılır. Oturum depolama belgelerini inceleyin: https://developers.google.com/assistant/conversational/storage-session.
|
typeOverrides[] |
İsteğe bağlı. Oturum kapsamlı türler. Oturum türü tanımları, mevcut türleri tamamlayabilir veya değiştirebilir. Tür adları benzersiz olmalıdır. |
languageCode |
Geçerli görüşme oturumunun dili. IETF BCP-47 dil kodunu (http://www.rfc-Editor.org/rfc/bcp/bcp47.txt) uygular. İşlem çok dilli özellikler kullanıyorsa kullanıcı yerel ayarından farklı olabilir. Örneğin, Handler_response.beklenen.dil_kodu ayarlandığında, sonraki tüm dönüşler için konuşma dilini değiştirir. Bu dil bu alana yansıtılır. |
Tür Geçersiz Kılma
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 gerekir? |
synonym |
|
Geçersiz Kılma Modu
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ımlanan tür tanımlarının yerini alacaktır. |
TYPE_MERGE |
Bu yanıttaki tür tanımları, daha önce tanımlanan tür tanımlarıyla birleştirilecek. Yeni tür tanımları, mevcut tür tanımlarının üzerine yazılacak. |
Eş Anlamlı Türü
Eş anlamlıları olan bir türü gösterir.
JSON gösterimi | |
---|---|
{
"entries": [
{
object ( |
Alanlar | |
---|---|
entries[] |
Zorunlu. Eş anlamlı kelime girişi listesi. |
Giriş
Eş anlamlı türü için bir girişi temsil eder.
JSON gösterimi | |
---|---|
{
"name": string,
"synonyms": [
string
],
"display": {
object ( |
Alanlar | |
---|---|
name |
Zorunlu. Girişin adı (ör. "bisiklet"). Geçerli bir tür değeri olarak yeniden tanımlanabilmesi için, bu alandaki girişin yinelenen eş anlamlılar alanına eklenmesi gerekir. |
synonyms[] |
Zorunlu. Girişin eş anlamlıları listesi (ör. "bisiklet", "döngü"). |
display |
İsteğe bağlı. Öğe görüntüsü bilgileri. |
Giriş Ekranı
JSON gösterimi | |
---|---|
{ "title": string, "description": string, "image": { object ( |
Alanlar | |
---|---|
title |
Zorunlu. Öğenin başlığı. Bu mesaja dokunulduğunda, kullanıcı yazmış gibi sohbet mesajında tekrar yayınlanır. Her başlık, koleksiyon öğeleri grubu arasında 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 öğesinin açıklama metninin altında görünen altbilgi metni. Üç satırlık metinle kesilmiş tek satır. |
openUrl |
Göz atma bandı öğesiyle ilişkili dokümanın URL'si. Göz atma bandı 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) uygular. Ancak komut dosyası alt etiketi dahil değildir. |
params |
İsteğe bağlı. Geçerli kullanıcıyla ilişkili tüm parametrelerin listesi. Kullanıcı depolama alanı dokümanlarını inceleyin: 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 belirtir. |
lastSeenTime |
Bu kullanıcıyla son etkileşimin zaman damgası. Kullanıcı, temsilciyle daha önce etkileşimde bulunmadıysa bu alan çıkarılır. Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
engagement |
Niyet abonelikleri de dahil olmak üzere mevcut kullanıcının etkileşimi. |
packageEntitlements[] |
Kullanıcının mevcut işlemle ilişkili Android paketiyle ilgili yararlanma hakları. |
permissions[] |
Kullanıcının bu işleme verdiği izinleri içerir. |
Hesap Bağlama Durumu
Son kullanıcının, hesabını bu uygulamaya bağlamış olup olmadığını belirtir. Hesap bağlama dokümanlarına göz atı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ı. |
Kullanıcı Doğrulama Durumu
Google'ın kullanıcıyı doğrulayıp doğrulamadığını belirtir. DOĞRULANDI durumu, parametreler alanını veya hesap bağlama özelliğini kullanarak görüşmeler arasında 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 kaydolduğu etkileşim mekanizmaları hakkında salt okunur bilgiler sağlar. Örneğin, kullanıcının tekrar aynı niyetle abone olmasını istememek için hangi amaçların halihazırda abone olduğunu bilmek yararlı olabilir. Yani, bu bilgiler yalnızca kullanıcı henüz abone olmamışsa günlük güncellemeleri veya push bildirimlerini ayarlamak için koşullu olarak rota oluşturmak üzere kullanılabilir. Kullanıcı etkileşimi dokümanlarını inceleyin: https://developers.google.com/assistant/engagement.
JSON gösterimi | |
---|---|
{ "pushNotificationIntents": [ { object ( |
Alanlar | |
---|---|
pushNotificationIntents[] |
Kullanıcının push bildirimini etkinleştirdiği niyetlerin listesini içerir. |
dailyUpdateIntents[] |
Kullanıcının günlük güncellemeyi etkinleştirdiği amaçların listesini içerir. |
IntentAboneliği
Mevcut bir IntentAbonelik açıklaması.
JSON gösterimi | |
---|---|
{ "intent": string, "contentTitle": string } |
Alanlar | |
---|---|
intent |
Abone olunan niyetin adı. |
contentTitle |
Aboneliğin kısa bir açıklaması. Bildirimin etiketi olarak ve Asistan kullanıcıdan izin istediğinde kullanılır. |
PackageEntitlements
Bir paket adıyla ilgili kullanıcı yararlanma haklarının listesi. Dijital iyi işlem dokümanlarına göz atın: 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 paket adı. |
entitlements[] |
Kullanıcının verilen 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 için Finsky docid'in son eki ve uygulama içi abonelik. Play InApp Billing API'deki getSku() ile eşleşir. Play InApp Faturalandırma belgelerini inceleyin: https://developer.android.com/google/play/billing. |
skuType |
SKU türü. |
inAppDetails |
Yalnızca uygulama içi satın alma işlemleri ve uygulama içi aboneler için mevcuttur. |
SKU Türü
Sıralamalar | |
---|---|
SKU_TYPE_UNSPECIFIED |
|
IN_APP |
Uygulama içi satın alma |
SUBSCRIPTION |
Abonelikler |
APP |
Ücretli uygulamalar |
İmzalıVeriler
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ılı bilgiyi https://developer.android.com/google/play/billing/billing_reference.html sayfasındaki 6. tabloda bulabilirsiniz. |
inAppDataSignature |
Play InApp Billing API'deki 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 isteyin. |
DEVICE_COARSE_LOCATION |
Kullanıcının yaklaşık konumunu, posta kodunu, şehri ve ülke kodunu isteyin. |
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 HomeGraph yapısını temsil eder.
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 ile ilgili belgelere göz atın: https://developers.google.com/assistant/conversational/storage-home.
|
Cihaz
Kullanıcının İşlem için istekte bulunmak üzere kullandığı cihazı gösterir.
JSON gösterimi | |
---|---|
{ "capabilities": [ enum ( |
Alanlar | |
---|---|
capabilities[] |
Gerekli. Cihazın İşlem isteğinde bulunan özellikleri. |
currentLocation |
İsteğe bağlı. Kullanıcının cihaz konumu. Bu alan, yalnızca son kullanıcı tarafından konum izinleri verildikten sonra doldurulur. Ayrıntılı ve ayrıntılı izne bağlı olarak hangi alanların ayarlanacağıyla ilgili daha fazla ayrıntı 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şkili saat dilimi. Tarih-saat değerlerini çözmek 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 ses medyalarını oynatabilir. |
INTERACTIVE_CANVAS |
Cihaz, etkileşimli bir tuval yanıtı gösterebilir. |
WEB_LINK |
Cihaz, bir web tarayıcısı 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ı beklenir. Tam konum izni, "administrativeArea" ve "addressLines" gibi ek alanları doldurur. |
TimeZone
IANA Saat Dilimi Veritabanı'ndaki 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". |
İçerik
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 yer alır.
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. |
MedyaBağlamı
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. Saniyede en fazla dokuz ondalık basamak içeren ve " |
index |
Medya yanıtındaki medya dosyaları listesinde geçerli etkin medya dosyasının 0 tabanlı dizini. |
TuvalBağlamı
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 ayarlandı. Bu ayar yalnızca istek için ayarlanır, yanıt için değil. Örneğin, bu bir yemek tarifi uygulamasıysa durum değeri : { "current_page" : 5, "last_page" : 3, } olabilir. Boyut sınırı 50 KB'tır. |
Beklenen
Sonraki diyalog dönüşüyle ilgili beklentileri açıklar.
JSON gösterimi | |
---|---|
{ "speech": [ string ] } |
Alanlar | |
---|---|
speech[] |
İşlemin, kullanıcının konuşmaya ağırlık verme kelimesinden beklediği kelime öbeklerinin listesi. En fazla 1.000 ifadeye izin verilir. Not: Bu alan, v2 API'deki BeklenenInput.speech_biasing_hints ile aynı anlama sahiptir. |