Method: fulfill

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 (Handler)
  },
  "intent": {
    object (Intent)
  },
  "scene": {
    object (Scene)
  },
  "session": {
    object (Session)
  },
  "user": {
    object (User)
  },
  "home": {
    object (Home)
  },
  "device": {
    object (Device)
  },
  "context": {
    object (Context)
  }
}
Alanlar
handler

object (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

object (Intent)

Zorunlu. Son eşleşen amacı temsil eder. https://developers.google.com/assistant/conversational/intents adresine göz atın.
scene

object (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

object (Session)

Zorunlu. Oturum kimliği ve oturum parametreleri gibi oturum verilerini saklar.
user

object (User)

Zorunlu. Görüşmeyi başlatan kullanıcı.
home

object (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

object (Device)

Zorunlu. Kullanıcının İşlem ile etkileşim kurmak için kullandığı cihazdaki bilgiler.
context

object (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 (Prompt)
  },
  "scene": {
    object (Scene)
  },
  "session": {
    object (Session)
  },
  "user": {
    object (User)
  },
  "home": {
    object (Home)
  },
  "device": {
    object (Device)
  },
  "expected": {
    object (Expected)
  }
}
Alanlar
prompt

object (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

object (Scene)

İsteğe bağlı. Mevcut sahneyi ve sonraki sahneyi temsil eder. Scene.next ayarlanırsa çalışma zamanı hemen belirtilen düzene geçer.
session

object (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

object (User)

İsteğe bağlı. Geri gönderilecek kullanıcı parametrelerini belirtmek için kullanın.
home

object (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

object (Device)

İsteğe bağlı. Kullanıcının erişebildiği Asistan cihazları arasında hareket etmek için kullanın.
expected

object (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

string

İ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 (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Alanlar
name

string

Zorunlu. Son eşleşen amacın adı.
params

map (key: string, value: object (IntentParameterValue))

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.

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

string

İ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

string

Zorunlu. Kullanıcının ifadesinden alınan orijinal metin değeri.
resolved

value (Value format)

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 (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}
Alanlar
name

string

Zorunlu. Geçerli sahnenin adı.
slotFillingStatus

enum (SlotFillingStatus)

Zorunlu. Slot doldurmanın mevcut durumu. Bu alan salt okunurdur.
slots

map (key: string, value: object (Slot))

Geçerli sahneyle ilişkilendirilen alanlar. İşleyici yanıtları, istekte gönderilmemiş yuvaları döndüremez.

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

object (NextScene)

İ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 (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}
Alanlar
mode

enum (SlotMode)

Yuvanın modu (zorunlu veya isteğe bağlı). Geliştirici tarafından ayarlanabilir.
status

enum (SlotStatus)

Alanın durumu.
value

value (Value format)

Alanın değeri. Yanıtta bu değer değiştirildiğinde, slot doldurma değeri de değişir.
updated

boolean

Slot değerinin son dönüşte toplanıp toplanmadığını gösterir. Bu alan salt okunurdur.
prompt

object (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 (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}
Alanlar
override

boolean

İ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

object (Simple)

İsteğe bağlı. İlk sesli ve yalnızca metin yanıtı.
content

object (Content)

İsteğe bağlı. Kullanıcıya gösterilecek kart, liste veya medya gibi bir içerik.
lastSimple

object (Simple)

İsteğe bağlı. Sesli ve yalnızca metin içeren son yanıt.
suggestions[]

object (Suggestion)

İ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.
canvas

object (Canvas)

İsteğe bağlı. Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder.
orderUpdate

object (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

string

İ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

string

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 content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}
Alanlar

content alanı.

content şunlardan yalnızca biri olabilir:
card

object (Card)

Temel bir kart.
image

object (Image)

Bir resim.
table

object (Table)

Tablo kartı.
media

object (Media)

Oynatılacak medya grubunu belirten yanıt.
collection

object (Collection)

Aralarından seçim yapabileceğiniz bir dizi seçenek sunan kart.
list

object (List)

Aralarından seçim yapabileceğiniz seçeneklerin listesini gösteren bir kart.
collectionBrowse

object (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 (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}
Alanlar
title

string

Kartın genel başlığı. İsteğe bağlı.
subtitle

string

İsteğe bağlı.
text

string

Kartın gövde metni. Biçimlendirme için sınırlı bir Markdown söz dizimini destekler. Resim yoksa gereklidir.
image

object (Image)

Kartın lokomotif resmi. Yükseklik 192 dp'ye sabitlenir. İsteğe bağlı.
imageFill

enum (ImageFill)

Resim arka planının nasıl doldurulacağı. İsteğe bağlı.
button

object (Link)

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

string

Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin,https://www.agentx.com/logo.png. Zorunlu.
alt

string

Erişilebilirlik için kullanılacak resmin metin açıklaması (ör. ekran okuyucular). Zorunlu.
height

integer

Resmin piksel cinsinden yüksekliği. İsteğe bağlı.
width

integer

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.

OpenUrl

JSON gösterimi 
{
  "url": string,
  "hint": enum (UrlHint)
}
Alanlar
url

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri
hint

enum (UrlHint)

URL türüyle ilgili bir ipucu gösterir.

UrlHint

Farklı URL ipucu türleri.

Sıralamalar
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 (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}
Alanlar
title

string

Tablonun genel başlığı. İsteğe bağlıdır ancak altyazı ayarlanmışsa ayarlanmalıdır.
subtitle

string

Tablonun alt başlığı. İsteğe bağlı.
image

object (Image)

Tabloyla ilişkilendirilen resim. İsteğe bağlı.
columns[]

object (TableColumn)

Başlıklar ve sütunların hizalaması.
rows[]

object (TableRow)

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

object (Link)

Düğme.

TableColumn

JSON gösterimi 
{
  "header": string,
  "align": enum (HorizontalAlignment)
}
Alanlar
header

string

Sütunun başlık metni.
align

enum (HorizontalAlignment)

İç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 (TableCell)
    }
  ],
  "divider": boolean
}
Alanlar
cells[]

object (TableCell)

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

boolean

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

string

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 (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}
Alanlar
mediaType

enum (MediaType)
startOffset

string (Duration format)

İlk medya nesnesinin başlangıç ofseti.

En fazla dokuz kesir basamağı içeren ve "s" ile sonlandırılan saniye cinsinden bir süre. Örnek: "3.5s".
optionalMediaControls[]

enum (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[]

object (MediaObject)

Medya Nesneleri Listesi
repeatMode

enum (RepeatMode)

Medya Nesneleri listesi için modu tekrar edin.
firstMediaObjectIndex

integer

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 (MediaImage)
  }
}
Alanlar
name

string

Bu medya nesnesinin adı.
description

string

Bu medya nesnesinin açıklaması.
url

string

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

object (MediaImage)

Medya kartıyla birlikte gösterilecek resim.

MediaImage

JSON gösterimi 
{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
Alanlar

image alanı.

image şunlardan yalnızca biri olabilir:
large

object (Image)

Albümün kapağı vb. büyük bir resim.
icon

object (Image)

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 (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
Alanlar
title

string

Koleksiyonun başlığı. İsteğe bağlı.
subtitle

string

Koleksiyonun alt başlığı. İsteğe bağlı.
items[]

object (CollectionItem)

Öğe listesi. En az 2, en fazla 10 olabilir.
imageFill

enum (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

string

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 (ListItem)
    }
  ]
}
Alanlar
title

string

Listenin başlığı. İsteğe bağlı.
subtitle

string

Listenin alt başlığı. İsteğe bağlı.
items[]

object (ListItem)

Öğe listesi. En az 2, en fazla 30 olabilir.

ListItem

Listedeki bir öğe

JSON gösterimi 
{
  "key": string
}
Alanlar
key

string

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 (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}
Alanlar
items[]

object (Item)

Öğe listesi. En az 2, en fazla 10 olabilir.
imageFill

enum (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 (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}
Alanlar
title

string

Zorunlu. Koleksiyon öğesinin başlığı.
description

string

Koleksiyon öğesinin açıklaması.
footer

string

Koleksiyon öğesinin açıklamanın altında görüntülenen altbilgi metni. Üç nokta ile kısaltılmış tek satırlık metin.
image

object (Image)

Koleksiyon öğesinin resmi.
openUriAction

object (OpenUrl)

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

string

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 (ContinuousMatchConfig)
  }
}
Alanlar
url

string

Yüklenecek etkileşimli tuval web uygulamasının URL'si. Ayarlanmazsa mevcut etkin tuvaldeki URL yeniden kullanılır.
data[]

value (Value format)

İ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

boolean

İsteğe bağlı. Varsayılan değer: false.
continuousMatchConfig

object (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 (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}
Alanlar
expectedPhrases[]

object (ExpectedPhrase)

Bu sürekli eşleme modu oturumunda, beklenen tüm olası ifadeler.
durationSeconds

integer

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

string

Sürekli eşleme modu oturumu sırasında eşleştirilecek ifade.
alternativePhrases[]

string

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 (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Alanlar
type
(deprecated)

enum (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

object (Order)
updateMask

string (FieldMask format)

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: "user.displayName,photo".
userNotification

object (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

string

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 (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Alanlar
googleOrderId

string

Google tarafından atanan sipariş kimliği.
merchantOrderId

string

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

string

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
(deprecated)

string

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

object (UserInfo)

Alıcı hakkında bilgi.
image

object (Image)

Siparişle ilişkilendirilen resim.
createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
transactionMerchant

object (Merchant)

Ö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

object (Contents)

Gerekli: Satır öğesi grubu olan sipariş içeriği.
priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.
followUpActions[]

object (Action)

Sipariş seviyesinde takip işlemleri.
paymentData

object (PaymentData)

Sipariş için ödemeyle ilgili veriler.
termsOfServiceUrl

string

Sipariş/teklif edilen sipariş için geçerli olan hizmet şartlarının bağlantısı.
note

string

Bir siparişe ekli notlar.
promotions[]

object (Promotion)

Bu siparişle ilişkili tüm promosyonlar.
disclosures[]

object (Disclosure)

Bu siparişle ilgili açıklamalar.
vertical
(deprecated)

object

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: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.
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

object (PurchaseOrderExtension)

Satın alma siparişi
ticket

object (TicketOrderExtension)

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 (PhoneNumber)
    }
  ]
}
Alanlar
email

string

Kullanıcı e-posta adresi, Ör. janedoe@gmail.com.
firstName

string

Kullanıcının adı.
lastName

string

Kullanıcının soyadı.
displayName

string

Kullanıcının görünen adı; ad veya soyadından farklı olabilir.
phoneNumbers[]

object (PhoneNumber)

Kullanıcının telefon numaraları.

PhoneNumber

Standart telefon numarası temsili.

JSON gösterimi 
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Alanlar
e164PhoneNumber

string

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

string

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

string

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

string

Resmin kaynak URL'si. Resimler JPG, PNG ve GIF (animasyonlu ve animasyonsuz) olabilir. Örneğin,https://www.agentx.com/logo.png. Zorunlu.
accessibilityText

string

Erişilebilirlik için kullanılacak resmin metin açıklaması (ör. ekran okuyucular). Zorunlu.
height

integer

Resmin piksel cinsinden yüksekliği. İsteğe bağlı.
width

integer

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 (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Alanlar
id

string

Varsa satıcıya atanan isteğe bağlı kimlik.
name

string

Satıcının adı (ör. "Panera Bread").
image

object (Image)

Satıcıyla ilişkili resim.
phoneNumbers[]

object (PhoneNumber)

Satıcının telefon numaraları.
address

object (Location)

Satıcının adresi.

Konum

Bir konumu temsil eden kapsayıcı.

JSON gösterimi 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Alanlar
coordinates

object (LatLng)

Coğrafi koordinatlar. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir.
formattedAddress

string

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

string

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

string

Ş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

object (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

string

Yerin adı.
phoneNumber

string

Konumun telefon numarası (ör. işletmenin bulunduğu konumun iletişim numarası veya teslimat konumunun telefon numarası).
notes

string

Konumla ilgili notlar.
placeId

string

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

number

Derece cinsinden enlem. [-90.0, +90.0] aralığında olmalıdır.
longitude

number

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

integer

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0 olarak ayarlanmalıdır.

Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır.
regionCode

string

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

string

İ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

string

İ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

string

İ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

string

İ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

string

İ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

string

İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir.
addressLines[]

string

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[]

string

İ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

string

İsteğe bağlı. Adresteki kuruluşun adı.

İçindekiler

Satır öğeleri için sarmalayıcı.

JSON gösterimi 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Alanlar
lineItems[]

object (LineItem)

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 (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Alanlar
id

string

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

string

Makbuzda görünen satır öğesinin adı. İzin verilen maksimum uzunluk 100 karakterdir.
userVisibleStateLabel
(deprecated)

string

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

object (Merchant)

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[]

object (PriceAttribute)

Satır öğesi seviyesinde fiyat ve düzenlemeler.
followUpActions[]

object (Action)

Satır öğesindeki takip işlemleri.
recipients[]

object (UserInfo)

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

object (Image)

Varsa, bu öğeyle ilişkili küçük resim.
description

string

Satır öğesi açıklaması.
notes[]

string

Bu satır öğesi için geçerli olan ek notlar (ör. iptal politikası).
disclosures[]

object (Disclosure)

Bu satır öğesiyle ilgili açıklamalar.
vertical
(deprecated)

object

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: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.
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

object (PurchaseItemExtension)

Mal, yiyecek vb. satın alma siparişleri
reservation

object (ReservationItemExtension)

Restoran, saç kesimi gibi rezervasyon siparişleri

PriceAttribute

Bir siparişin veya satır öğesinin fiyat özelliği.

JSON gösterimi 
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}
Alanlar
type

enum (Type)

Gerekli: Para özelliği türü.
name

string

Gerekli: Fiyat özelliğinin kullanıcı tarafından gösterilen dizesi. Bu numara, satıcı tarafından gönderilir ve yerelleştirilmiş.
id

string

İsteğe bağlı: Bu fiyatın karşılık geldiği satır öğesinin kimliği.
state

enum (State)

Gerekli: Fiyatın durumu: Tahmin ve Gerçek değer.
taxIncluded

boolean

Fiyatın vergi dahil olup olmadığı.
spec alanı. Parasal tutarı veya milisaniye cinsinden yüzdeyi temsil eder. spec şunlardan yalnızca biri olabilir:
amount

object (Money)

Para tutarı.
amountMillipercentage
(deprecated)

integer

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

string

ISO 4217'de tanımlanan 3 harfli para birimi kodu.
amountInMicros

string (int64 format)

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 (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Alanlar
type

enum (Type)

Gerekli: İşlem türü.
title

string

Kullanıcıya gösterilen işlemin başlığı veya etiketi. İzin verilen maksimum uzunluk 100 karakterdir.
openUrlAction

object (OpenUrlAction)

Gerçekleştirilecek işlem.
actionMetadata

object (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 (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Alanlar
url

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamayla Bağlantılı Uygulama veya web sayfası açmak için http/https URL'leri
androidApp

object (AndroidApp)

URL'nin bir Android Uygulaması tarafından karşılanması bekleniyorsa Android Uygulaması ile ilgili bilgiler.
urlTypeHint

enum (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 (VersionFilter)
    }
  ]
}
Alanlar
packageName

string

Android Fulfillment belirtilirken paket adı belirtilmelidir.
versions[]

object (VersionFilter)

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

integer

Minimum sürüm kodu veya 0 (bu değerler dahil).
maxVersion

integer

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

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

İfşa etme

Kullanıcıya sunulabilecek bir ürün, hizmet veya politika açıklaması.

JSON gösterimi 
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Alanlar
title

string

Açıklamanın başlığı. Örnek: "Güvenlik bilgileri".
disclosureText

object (DisclosureText)

Açıklamanın içeriği. Web bağlantılarına izin verilir.
presentationOptions

object (DisclosurePresentationOptions)

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 (TextLink)
    }
  ]
}
Alanlar
template

string

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.

DisclosurePresentationOptions

Açıklamanın sunulmasıyla ilgili seçenekler.

JSON gösterimi 
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Alanlar
presentationRequirement

enum (PresentationRequirement)

Açıklamanın sunum şartı.
initiallyExpanded

boolean

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 (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Alanlar
status

enum (PurchaseStatus)

Gerekli: Satır öğesi düzeyinde durum.
userVisibleStatusLabel

string

Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.
type

enum (PurchaseType)

Gerekli: Satın alma türü.
productId
(deprecated)

string

Bu satır öğesiyle ilişkili ürün veya teklif kimliği.
quantity

integer

Öğenin miktarı.
unitMeasure

object (MerchantUnitMeasure)

Birim ölçüsü. Seçilen birimlerde öğenin boyutunu belirtir. Birim fiyatı belirlemek için boyut ve etkin fiyat kullanılır.
returnsInfo

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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[]

object (ItemOption)

Ek eklentiler veya alt öğeler.
productDetails

object (ProductDetails)

Ürünle ilgili ayrıntılar.
extension
(deprecated)

object

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. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

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 (Unit)
}
Alanlar
measure

number

Değer: Örnek 1.2.
unit

enum (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

boolean

True (doğru) değerine ayarlanırsa dönüşe izin verilir.
daysToReturn

integer

Bu süre içinde iade edebilirsiniz.
policyUrl

string

İ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 (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Alanlar
id

string

Bu hizmet seçeneğinin benzersiz tanımlayıcısı.
fulfillmentType

enum (Type)

Gerekli: Sipariş karşılamanın türü.
expectedFulfillmentTime

object (Time)

Zaman aralığı belirtilmişse aralık veya tek zaman belirtilmişse GMR. Beklenen teslimat veya teslim alma saati.
expectedPreparationTime

object (Time)

Zaman aralığı belirtilmişse aralık veya tek zaman belirtilmişse GMR. Yemeğin hazırlanması beklenen süre. Tek seferlik tercih edilir.
location

object (Location)

Teslim alma veya teslimat konumu.
expireTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
price

object (PriceAttribute)

Bu seçeneğin maliyeti.
fulfillmentContact

object (UserInfo)

Bu istek karşılama için kullanıcı iletişim bilgileri.
shippingMethodName

string

Kullanıcı tarafından seçilen gönderim yönteminin adı.
storeCode

string

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

object (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

string

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 (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Alanlar
pickupType

enum (PickupType)

Teslim alma yöntemi (ör. INSTORE, CURBSIDE vb.)
curbsideInfo

object (CurbsideInfo)

Arabaya teslim alma bilgilerine özel ayrıntılar pickupType" "CURBSIDE" değilse bu alan yoksayılır.
checkInInfo[]

object (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 (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Alanlar
curbsideFulfillmentType

enum (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

object (Vehicle)

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 (Image)
  }
}
Alanlar
make

string

Araç markası (ör. "Honda"). Bu, kullanıcıya gösterilir ve yerelleştirilmelidir. Zorunlu.
model

string

Araç modeli (ör. "Grom"). Bu, kullanıcıya gösterilir ve yerelleştirilmelidir. Zorunlu.
licensePlate

string

Araç plaka numarası (ör. "1ABC234"). Zorunlu.
colorName

string

Araç rengi adı (ör. siyah) İsteğe bağlı.
image

object (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 (CheckInType)
}
Alanlar
checkInType

enum (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 (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Alanlar
id

string

Öğe olan seçenekler için benzersiz öğe kimliği.
name

string

Seçenek adı.
prices[]

object (PriceAttribute)

Seçenek toplam fiyatı.
note

string

Seçenekle ilgili not.
quantity

integer

Öğe olan seçenekler için miktar.
productId

string

Bu seçenekle ilişkili ürün veya teklif kimliği.
subOptions[]

object (ItemOption)

İç 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

string

Bu satır öğesiyle ilişkili ürün veya teklif kimliği.
gtin

string

Ürünün Global Ticari Öğe Numarası. OfferId, Merchant Center'da mevcut değilse yararlıdır. İsteğe bağlı.
plu

string

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

string

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

map (key: string, value: string)

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ı.

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

ReservationItemExtension

Restoran, saç kesimi gibi rezervasyon siparişleri için satır öğesi içerikleri.

JSON gösterimi 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}
Alanlar
status

enum (ReservationStatus)

Zorunlu: Rezervasyon durumu.
userVisibleStatusLabel

string

Gerekli: Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.
type

enum (ReservationType)

Rezervasyon türü. Tür seçeneklerinden hiçbiri geçerli değilse bu ayar kaldırılabilir.
reservationTime

object (Time)

Hizmetin/etkinliğin gerçekleşmesinin planlandığı zaman. Zaman aralığı, tarih veya kesin tarih saat olabilir.
userAcceptableTimeRange

object (Time)

Kullanıcının kabul edebileceği zaman aralığı.
confirmationCode

string

Bu rezervasyonun onay kodu.
partySize

integer

Kullanıcı sayısı.
staffFacilitators[]

object (StaffFacilitator)

Rezervasyonla ilgili işlemleri yaptıracak personel yöneticileri. Ör. Kuaför.
location

object (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 (Image)
  }
}
Alanlar
name

string

Personel eğitimini düzenleyen kişinin adı. Ör. "Can Demir"
image

object (Image)

Sanatçının resimleri.

PaymentData

Bir siparişle ilgili ödeme verileri.

JSON gösterimi 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Alanlar
paymentResult

object (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

object (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 result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Alanlar
result alanı. Google ödeme verileri veya satıcı ödeme yöntemi sağlanmış. result şunlardan yalnızca biri olabilir:
googlePaymentData

string

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

string

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 (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Alanlar
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

İşlem için kullanılan ödeme yönteminin bilgileri.
paymentMethodProvenance

enum (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 (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Alanlar
paymentType

enum (PaymentType)

Ödemenin türü.
paymentMethodDisplayName

string

Ödeme yönteminin kullanıcı tarafından görünen adı. Örneğin, VISA **** 1234 Check acct **** 5678
paymentMethodVoiceName

string

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

string

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 (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Alanlar
status

enum (PurchaseStatus)

Gerekli: Sipariş için Genel Durum.
userVisibleStatusLabel

string

Durum için kullanıcı tarafından görülebilen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.
type

enum (PurchaseType)

Gerekli: Satın alma türü.
returnsInfo

object (PurchaseReturnsInfo)

Siparişin iade bilgileri.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Siparişin sipariş karşılama bilgileri.
purchaseLocationType

enum (PurchaseLocationType)

Satın alma işleminin yapıldığı yer (mağazada / internette)
errors[]

object (PurchaseError)

İsteğe bağlı: Bu siparişin reddedilmesinden kaynaklanan hatalar.
extension
(deprecated)

object

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. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

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 (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Alanlar
type

enum (ErrorType)

Gerekli: Bu, bir siparişin satıcı tarafından reddedilmesinin ayrıntılı nedenini temsil eder.
description

string

Ek hata açıklaması.
entityId

string

Hataya karşılık gelen varlık kimliği. Örnek; LineItemId / ItemOptionId'ye karşılık gelebilir.
updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE hata türüyle alakalıdır.
availableQuantity

integer

Ş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 (TicketEvent)
  }
}
Alanlar
ticketEvent

object (TicketEvent)

Etkinlik, tüm satır öğesi biletlerine uygulandı.

TicketEvent

Tek bir etkinliği temsil eder.

JSON gösterimi 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Alanlar
type

enum (Type)

Gerekli: Bilet etkinliğinin türü (ör. film, konser).
name

string

Zorunlu: Etkinliğin adı. Örneğin, etkinlik bir filmse, bunun film adı olması gerekir.
description

string

Etkinliğin açıklaması.
url

string

Etkinlik bilgisinin URL'si.
location

object (Location)

Etkinliğin gerçekleştiği veya bir kuruluşun bulunduğu konum.
eventCharacters[]

object (EventCharacter)

Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya aktörleri ya da bir konserin sanatçıları vb.
startDate

object (Time)

Başlangıç zamanı.
endDate

object (Time)

Bitiş zamanı.
doorTime

object (Time)

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 (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Alanlar
type

enum (Type)

Etkinlik karakterinin türü (ör. oyuncu veya yönetmen).
name

string

Karakterin adı.
image

object (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

string

Kullanıcı bildiriminin başlığı. İzin verilen maksimum uzunluk 30 karakterdir.
text

string

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

string

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 (TypeOverride)
    }
  ],
  "languageCode": string
}
Alanlar
id

string

Zorunlu. Mevcut sohbet oturumunun genel olarak benzersiz kimliği. Bu alan salt okunurdur.
params

map (key: string, value: value (Value format))

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.

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

object (TypeOverride)

İ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

string

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 (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}
Alanlar
name

string

Zorunlu. Eklenecek veya geçersiz kılınacak türün adı.
mode

enum (TypeOverrideMode)

Zorunlu. Bu türün diğer tür değerleriyle nasıl birleştirileceği.
synonym

object (SynonymType)

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 (Entry)
    }
  ]
}
Alanlar
entries[]

object (Entry)

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 (EntryDisplay)
  }
}
Alanlar
name

string

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[]

string

Zorunlu. Girişin eş anlamlılarının listesi (ör. "bisiklet", "bisiklet").
display

object (EntryDisplay)

İsteğe bağlı. Öğe görünümü bilgileri.

EntryDisplay

JSON gösterimi 
{
  "title": string,
  "description": string,
  "image": {
    object (Image)
  },
  "footer": string,
  "openUrl": {
    object (OpenUrl)
  }
}
Alanlar
title

string

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

string

İsteğe bağlı. Kartın gövde metni.
image

object (Image)

İsteğe bağlı. Gösterilecek resim.
footer

string

İ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

object (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 (AccountLinkingStatus),
  "verificationStatus": enum (UserVerificationStatus),
  "lastSeenTime": string,
  "engagement": {
    object (Engagement)
  },
  "packageEntitlements": [
    {
      object (PackageEntitlements)
    }
  ],
  "permissions": [
    enum (Permission)
  ]
}
Alanlar
locale

string

İ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

map (key: string, value: value (Value format))

İ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.

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

enum (AccountLinkingStatus)

Kullanıcı hesabının uygulamaya bağlı olup olmadığı.
verificationStatus

enum (UserVerificationStatus)

Kullanıcının doğrulama durumunu gösterir.
lastSeenTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
engagement

object (Engagement)

Amaçlara yönelik tüm abonelikler de dahil olmak üzere mevcut kullanıcının etkileşimi.
packageEntitlements[]

object (PackageEntitlements)

Kullanıcının geçerli işlemle ilişkili Android paketiyle ilgili yararlanma hakları.
permissions[]

enum (Permission)

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 (IntentSubscription)
    }
  ],
  "dailyUpdateIntents": [
    {
      object (IntentSubscription)
    }
  ]
}
Alanlar
pushNotificationIntents[]

object (IntentSubscription)

Kullanıcının push bildirimlerini etkinleştirdiği amaçların listesini içerir.
dailyUpdateIntents[]

object (IntentSubscription)

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

string

Abone olunan amacın adı.
contentTitle

string

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 (Entitlement)
    }
  ]
}
Alanlar
packageName

string

İşlem paketinde belirtilen Android paketi adı.
entitlements[]

object (Entitlement)

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 (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
Alanlar
sku

string

Ü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

enum (SkuType)

SKU'nun türü.
inAppDetails

object (SignedData)

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

object (Struct format)

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

string

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

map (key: string, value: value (Value format))

İ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.

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

Cihaz

Kullanıcının Action'a istekte bulunmak için kullandığı cihazı temsil eder.

JSON gösterimi 
{
  "capabilities": [
    enum (Capability)
  ],
  "currentLocation": {
    object (Location)
  },
  "timeZone": {
    object (TimeZone)
  }
}
Alanlar
capabilities[]

enum (Capability)

Zorunlu. İşlem için istekte bulunan cihazın özellikleri.
currentLocation

object (Location)

İ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

object (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.
HOME_STORAGE Cihaz, evdeki depolama alanını kaydetmeyi ve getirmeyi destekleyebilir.

Konum

Bir konumu temsil eden kapsayıcı.

JSON gösterimi 
{
  "coordinates": {
    object (LatLng)
  },
  "postalAddress": {
    object (PostalAddress)
  }
}
Alanlar
coordinates

object (LatLng)

Coğrafi koordinatlar. [DEVICE_PRECISE_LOCATION] iznini gerektirir.
postalAddress

object (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

string

IANA Saat Dilimi Veritabanı saat dilimi, ör. "America/New_York".
version

string

İ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 (MediaContext)
  },
  "canvas": {
    object (CanvasContext)
  }
}
Alanlar
media

object (MediaContext)

Mevcut etkin medya oturumuyla ilgili bağlam bilgilerini içerir.
canvas

object (CanvasContext)

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

string (Duration format)

Mevcut etkin medya dosyasının medya ilerleme durumu.

En fazla dokuz kesir basamağı içeren ve "s" ile sonlandırılan saniye cinsinden bir süre. Örnek: "3.5s".
index

integer

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

value (Value format)

İ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[]

string

İş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.