Method: fulfill

Karşılama API'sini temsil eden TBG

HTTP isteği

POST https://webhook_handler_service.googleapis.com/fulfill

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "handler": {
    object (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" adında bir işleyici olabilir.

intent

object (Intent)

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

scene

object (Scene)

İsteğe bağlı. İşlev çağrıldığında mevcut ve bir sonraki sahne hakkında bilgiler. Sipariş karşılama çağrısı bir sahne kapsamında yapıldığında doldurulur. https://developers.google.com/assistant/conversational/scenes adresine göz atın.

session

object (Session)

Zorunlu. Oturum kimliği ve oturum parametreleri gibi oturum verilerini muhafaza eder.

user

object (User)

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

home

object (Home)

İsteğe bağlı. Hedef cihazın ait olduğu HomeGraph yapısıyla ilgili bilgiler. https://developers.google.com/actions/smarthome/concepts/homegraph adresini ziyaret edin.

device

object (Device)

Zorunlu. Kullanıcının İşlem ile etkileşimde bulunmak için kullandığı cihazdaki bilgiler.

context

object (Context)

İsteğe bağlı. Talebin mevcut bağlamıyla ilgili bilgiler. Etkin medya oturumu bilgilerini veya tuval bilgilerini içerir ancak bunlarla sınırlı değildir.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Bir geliştiricinin Actions on Google'a karşılamasından sonra gönderilen yanıtı temsil eder.

JSON gösterimi
{
  "prompt": {
    object (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 mesajlara eklenir.

scene

object (Scene)

İsteğe bağlı. Geçerli ve sonraki sahneyi temsil eder. Scene.next ayarlanmışsa çalışma zamanı belirtilen sahneye hemen geçer.

session

object (Session)

İsteğe bağlı. Geçerli oturumla ilgili verileri açıklar. Oturum parametreleri, istek karşılama tarafından oluşturulabilir, güncellenebilir veya kaldırılabilir.

user

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 HomeGraph yapısıyla ilgili parametreleri belirtmek için kullanılır. https://developers.google.com/actions/smarthome/concepts/homegraph adresini ziyaret edin.

device

object (Device)

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

expected

object (Expected)

İsteğe bağlı. Bir sonraki diyalog dönüşü için beklentileri açıklar.

İşleyici

Actions on Google'daki etkinlik bilgilerini sipariş karşılama ile eşleyen bir sipariş karşılama işleyiciyi temsil eder. İstek karşılamada hangi kodu çalıştırmanız gerektiğini belirlemek için işleyici adını kullanın. Örneğin, bir işleyici, "OrdersLookup" gibi bir işleyici adıyla birlikte bir kullanıcının sipariş bilgilerini almak için kullanılabilir. diğeri ise "GetProductInfo" gibi bir işleyici adıyla veritabanından ürün bilgilerini alabilir.

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

string

İsteğe bağlı. İşleyicinin adı.

Amaç

Niyeti temsil eder. https://developers.google.com/assistant/conversational/intents adresine göz atın.

JSON gösterimi
{
  "name": string,
  "params": {
    string: {
      object (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. Bu, tanımlanan parametrenin adı ile kullanıcı girişinden tanımlanan parametrenin değerinin eşleştirilmesidir. Eşleşen amaçta tanımlanan ve tanımlanan tüm parametreler burada gösterilir.

"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ü olarak girdiği giriş. Bu alan, kullanıcı girişine göre bir amaç eşleştiğinde doldurulur.

IntentParameterValue

Amaç parametresi için bir değeri temsil eder. https://developers.google.com/assistant/conversational/types adresine göz atın.

JSON gösterimi
{
  "original": string,
  "resolved": value
}
Alanlar
original

string

Zorunlu. Orijinal metin değeri kullanıcının söylediklerinden alındı.

resolved

value (Value format)

Zorunlu. Kullanıcı girişinden çıkarılan parametrenin yapılandırılmış değeri. Bu alan yalnızca parametre, eşleşen amaçta tanımlıysa ve parametre değeri intent eşleştirme sırasında tanımlanabilirse doldurulur.

Sahne

Bir sahneyi temsil etme. Sahneler, karşılama çağrısı yapabilir, istem ekleyebilir ve kullanıcıdan alan değerlerini toplayabilir. Sahneler etkinlikler veya amaçlar tarafından tetiklenir ve diğer sahnelere geçiş için etkinlikleri tetikleyip amaçları eşleştirebilir.

JSON gösterimi
{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}
Alanlar
name

string

Zorunlu. Geçerli sahnenin adı.

slotFillingStatus

enum (SlotFillingStatus)

Zorunlu. Boşluk doldurma işleminin mevcut durumu. Bu alan salt okunurdur.

slots

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

Geçerli sahneyle ilişkilendirilen alanlar. İşleyici yanıtları, istekte gönderilmeyen alanları 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ı. Sıradaki yürütülecek sahnedeki bilgiler.

SlotFillingStatus

Boşluk doldurmanın mevcut durumunu gösterir.

Sıralamalar
UNSPECIFIED Kullanım alanı doldurulmadığında yedek değer.
INITIALIZED Alanlar başlatıldı ancak alan doldurma başlamadı.
COLLECTING Alan değerleri toplanıyor.
FINAL Tüm alan değerleri nihaidir ve değiştirilemez.

Alan

Bir alanı temsil eder.

JSON gösterimi
{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}
Alanlar
mode

enum (SlotMode)

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

status

enum (SlotStatus)

Zaman aralığının durumu.

value

value (Value format)

Alanın değeri. Yanıtta bu değerin değiştirilmesi, alan doldurmadaki değeri değiştirir.

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ı. Bu istem, gerekli bir alanı doldurması gerektiğinde kullanıcıya gönderilir. Bu istem, konsolda tanımlanmış mevcut istemi geçersiz kılar. Bu alan webhook isteğine dahil değildir.

SlotMode

Bir alanın modunu (zorunlu olup olmadığını) temsil eder.

Sıralamalar
MODE_UNSPECIFIED Kullanım alanı doldurulmadığında yedek değer.
OPTIONAL Aralıkın, boşluk doldurmayı tamamlamak için gerekli olmadığını gösterir.
REQUIRED Boşluk doldurmayı tamamlamak için zaman aralığının gerektiğini gösterir.

SlotStatus

Bir alanın durumunu temsil eder.

Sıralamalar
SLOT_UNSPECIFIED Kullanım alanı doldurulmadığında yedek değer.
EMPTY Alanda herhangi bir değer olmadığını gösterir. Bu durum yanıt aracılığıyla değiştirilemez.
INVALID Alan değerinin geçersiz olduğunu gösterir. Bu durum, yanıt aracılığıyla ayarlanabilir.
FILLED Alanda bir değer olduğunu gösterir. Bu durum yanıt aracılığıyla değiştirilemez.

İstem

Bir kullanıcıya verilen yanıtı temsil etme. https://developers.google.com/assistant/conversational/prompts adresine göz atın.

JSON gösterimi
{
  "override": boolean,
  "firstSimple": {
    object (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 iletilerin önceden tanımlanmış iletilerle birleştirilme şekli. "true" (doğru) önceden tanımlanmış tüm iletileri (ilk ve son basit, içerik, öneri bağlantısı ve tuval) temizler ve bu istemde tanımlanan iletileri ekler. "yanlış" bu istemde tanımlanan iletileri önceki yanıtlarda tanımlanan iletilere ekler. Bu alan "false" olarak bırakılıyor Basit istemler, Öneriler istemi ve Tuval istemi (İçerik isteminin bir parçası) içindeki bazı alanlara da ekleme yapılabilir. İstemde tanımlanırsa İçerik ve Bağlantı iletilerinin her zaman üzerine yazılır. Varsayılan değer "false"tur.

firstSimple

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ı. Son sesli ve yalnızca metin yanıt.

suggestions[]

object (Suggestion)

İsteğe bağlı. Kullanıcıya gösterilecek öneriler. Bunlar, her zaman yanıtın sonunda gösterilir. "Geçersiz kıl" alanına "false" (yanlış) değeri eklenirse bu alanda tanımlanan başlıklar, önceden tanımlanmış tüm öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır.

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ı işlem, işlem akışı sırasında siparişi aldıktan sonra OrderUpdate ile yanıt verir. Google bu güncellemeyi aldıktan sonra siparişe kaydeder ve başarılı olursa görüntüleme cihazlarında gönderilen TTS ile birlikte bir makbuz kartı gösterir.

Basit

Kullanıcıya gönderilmesi için basit bir istemi temsil eder. https://developers.google.com/assistant/conversational/prompts-simple adresine göz atın.

JSON gösterimi
{
  "speech": string,
  "text": string
}
Alanlar
speech

string

İsteğe bağlı. Kullanıcıya söylenecek konuşmayı temsil eder. SSML veya metin okuma olabilir. "Geçersiz kıl" alanındaki istem "true" değerine ayarlandığında, bu alanda tanımlanan konuşma önceki Basit istemin konuşmasının yerini alır. https://developers.google.com/assistant/conversational/ssml adresine göz atın.

text

string

Sohbet balonunda görüntülenecek isteğe bağlı metin. Belirtilmezse yukarıdaki konuşma alanının görüntülemesi kullanılır. Uzunluk sınırı 640 karakterdir. "Geçersiz kıl" alanındaki istem "true" ise bu alanda tanımlanan metin önceki Basit istemin metniyle değiştirilir.

İçerik

Zengin istemler veya seçim istemleri için kapsayıcı nesnesi.

JSON gösterimi
{

  // Union field 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

Birleştirme alanı content.

content şunlardan yalnızca biri olabilir:

card

object (Card)

Temel kart.

image

object (Image)

Bir resim.

table

object (Table)

Tablo kartı.

media

object (Media)

Oynatılacak bir grup medyayı gösteren yanıt.

collection

object (Collection)

Bir dizi seçenek sunan kart.

list

object (List)

Seçebileceğiniz seçeneklerin listesini sunan bir kart.

collectionBrowse

object (CollectionBrowse)

Açılacak bir web sayfası koleksiyonu sunan kart.

Kart

Bazı bilgileri görüntülemek için kullanılan temel kart, ör. bir resim ve/veya metin. https://developers.google.com/assistant/conversational/prompts-rich#basic_card adresine göz atın.

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (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 dizimi grubunu destekler. Resim mevcut olmadığı sürece gereklidir.

image

object (Image)

Kart için hero resim. Yükseklik 192 dp olarak sabitlendi. İ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 bir resim gösteriliyor. https://developers.google.com/assistant/conversational/prompts-rich#image-cards adresini ziyaret edin.

JSON gösterimi
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
Alanlar
url

string

Resmin kaynak URL'si. Resimler JPG, PNG ve GIF biçiminde (animasyonlu veya 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 etkileyecek olası resim görüntüleme seçenekleri. Bu, resmin en boy oranı, görüntü kapsayıcısının en boy oranıyla eşleşmediğinde kullanılmalıdır.

Sıralamalar
UNSPECIFIED
GRAY Resim ile görüntü kapsayıcısı arasındaki boşlukları gri çubuklarla doldurun.
WHITE Resim ile görüntü kapsayıcısı arasındaki boşlukları beyaz çubuklarla doldurun.
CROPPED Resim, genişlik ve yüksekliğinin kapsayıcı boyutlarıyla eşleşecek veya bu boyutların üzerinde olacak şekilde ölçeklendirilir. Bu işlemde, ölçeklendirilmiş resim yüksekliği kapsayıcı yüksekliğinden fazlaysa resmin üst ve alt kısmı kırpılabilir. Ölçeklendirilmiş resim genişliği kapsayıcı genişliğinden fazlaysa resmin sol ve sağ kısmı kırpılabilir. Bu, "Yakınlaştırma Modu"na benzer TV'de 4:3 video oynattığını varsayalım.

OpenUrl

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

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls

hint

enum (UrlHint)

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

UrlHint

Farklı URL ipuçları türleri.

Sıralamalar
AMP Doğrudan AMP içeriğine veya aracılığıyla AMP içeriğine başvuruda bulunan standart URL'ye yönlendiren URL. https://amp.dev/ sayfasına bakın.

Tablo

Bir metin tablosunu gösteren tablo kartı. https://developers.google.com/assistant/conversational/prompts-rich#table_cards adresine göz atın.

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}
Alanlar
title

string

Tablonun genel başlığı. İsteğe bağlıdır ancak alt başlık 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österileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi satırların gösterileceğini görmek için lütfen simülasyon aracıyla test edin. WEB_BROWSER özelliğini destekleyen yüzeylerde, kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz.

button

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)

İçerik sütunuyla yatay hizalama. Belirtilmemişse içerik ön kenarla hizalanır.

HorizontalAlignment

Hücredeki içeriğin hizalaması.

Sıralamalar
UNSPECIFIED
LEADING Hücrenin ön kenarı. Bu, varsayılan ayardır.
CENTER İçerik, sütunun ortasına hizalanır.
TRAILING İçerik, sütunun son kenarıyla hizalanır.

TableRow

Tablodaki bir satırı açıklar.

JSON gösterimi
{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}
Alanlar
cells[]

object (TableCell)

Bu satırdaki hücreler. İlk 3 hücrenin gösterileceği garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzey için hangi hücrelerin gösterileceğini görmek üzere lütfen simülasyon aracıyla test yapın.

divider

boolean

Her satırdan sonra bir ayırıcı olması gerekip gerekmediğini belirtir.

TableCell

Bir satırdaki bir hücreyi açıklar.

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

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 kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden süre. Örnek: "3.5s".

optionalMediaControls[]

enum (OptionalMediaControls)

Bu medya yanıtı oturumunun destekleyebileceği isteğe bağlı medya kontrolü türleri. Ayarlanırsa belirli bir medya etkinliği gerçekleştiğinde 3. tarafa istek gönderilir. Ayarlanmazsa 3p yine de TAMAMLANDI ve BAŞARISIZ olmak üzere iki varsayılan kontrol türünü işlemelidir.

mediaObjects[]

object (MediaObject)

Medya Nesneleri Listesi

repeatMode

enum (RepeatMode)

Medya Nesneleri listesi için tekrar modu.

firstMediaObjectIndex

integer

mediaObjects içindeki ilk Medya Nesnesi'nin 0 tabanlı dizini. Belirtilmemişse, sıfır veya sınırların dışındaysa oynatma, mediaObjects içindeki ilk medya nesnesinde başlar.

MediaType

Bu yanıtın medya türü.

Sıralamalar
MEDIA_TYPE_UNSPECIFIED
AUDIO Ses dosyası.
MEDIA_STATUS_ACK Medya durum raporunu onaylama yanıtı.

OptionalMediaControls

Medya yanıtının destekleyebileceği isteğe bağlı medya kontrolü türleri

Sıralamalar
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED Belirtilmemiş değer
PAUSED Etkinlik duraklatıldı. Kullanıcı medyayı duraklattığında tetiklenir.
STOPPED Etkinlik durduruldu. Kullanıcı medya oynatma sırasında 3. oturumdan çıktığında tetiklenir.

MediaObject

Tek bir medya nesnesini temsil eder

JSON gösterimi
{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}
Alanlar
name

string

Bu medya nesnesinin adı.

description

string

Bu medya nesnesinin açıklaması.

url

string

Medya içeriğini gösteren URL. MP3 dosyaları bir web sunucusunda barındırılmalı ve HTTPS URL'si aracılığıyla herkese açık olmalıdır. Canlı yayın yalnızca MP3 biçiminde desteklenir.

image

object (MediaImage)

Medya kartıyla 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

Birleştirme alanı image.

image şunlardan yalnızca biri olabilir:

large

object (Image)

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

icon

object (Image)

Başlığın sağında küçük bir resim simgesi görüntülenir. 36x36 dp olarak yeniden boyutlandırıldı.

RepeatMode

Medya nesnelerinin listesi için tekrar modu türleri.

Sıralamalar
REPEAT_MODE_UNSPECIFIED KAPALI durumuna eşdeğerdir.
OFF Son medya nesnesinin sonunda medya oturumunu sonlandırın.
ALL Son medya nesnesinin sonuna ulaşıldığında ilk medya nesnesinin başına döngü oluştur.

Koleksiyon

Aralarından seçim yapabileceğiniz bir dizi seçenek sunan bir kart. https://developers.google.com/assistant/conversational/prompts-selection#collection adresine göz atın.

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (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. Değer 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ürdeki giriş anahtarı adıyla eşleşen NLU anahtarı.

Liste

Seçebileceğiniz seçeneklerin listesini sunan bir kart. https://developers.google.com/assistant/conversational/prompts-selection#list adresine göz atın.

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (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. Değer en az 2, en fazla 30 olabilir.

ListItem

Listedeki bir öğe

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

string

Zorunlu. İlişkili Türdeki giriş anahtarı adıyla eşleşen NLU anahtarı.

CollectionBrowse

Bir dizi web dokümanını, büyük parçalı öğelerin koleksiyonu olarak sunar. İlişkili web dokümanlarını bir web görüntüleyicide başlatmak için öğeler seçilebilir. https://developers.google.com/assistant/conversational/prompts-selection#collectionBrowse adresine göz atın.

JSON gösterimi
{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}
Alanlar
items[]

object (Item)

Öğe listesi. Değer en az 2, en fazla 10 olabilir.

imageFill

enum (ImageFill)

Resim görüntüleme seçeneğinin türü.

Öğe

Koleksiyondaki öğe.

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

string

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

description

string

Koleksiyon öğesinin açıklaması.

footer

string

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

image

object (Image)

Koleksiyon öğesinin resmi.

openUriAction

object (OpenUrl)

Zorunlu. Öğe seçildiyse açılacak URI.

Öneri

Asistan istemi gösterdiğinde öneriler, görüntüleme özellikli cihazlardaki kullanıcılara öneri çipleri sunar. Sohbeti devam ettirmek veya özetlemek için kullanıcı yanıtlarıyla ilgili ipucu vermek amacıyla öneri çiplerini kullanın. Öneri çipine dokunulduğunda, gösterilen metin, kullanıcı yazmış gibi görüşmeye tam olarak geri döner. https://developers.google.com/assistant/conversational/prompts#suggestions adresine göz atın.

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

string

Zorunlu. Öneri çipinde gösterilen metin. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, öneri çipi grubu içinde benzersiz olmalıdır. Maksimum 25 karakter

Tuval

Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, "firstSimple" ile birlikte kullanılabilir. alanına girin. Yanıtın maksimum boyutu 50 bin bayttır. https://developers.google.com/assistant/interactivecanvas adresini ziyaret edin.

JSON gösterimi
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}
Alanlar
url

string

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

data[]

value (Value format)

İsteğe bağlı. Tam sayfa deneyim web sayfasına etkinlik olarak aktarılacak JSON verileri. "Geçersiz kıl" içeren istemdeki alanın "false" olması Bu Canvas isteminde tanımlanan veri değerleri, önceki Canvas istemlerinde tanımlanan veri değerlerinden sonra eklenecek.

suppressMic

boolean

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

continuousMatchConfig

object (ContinuousMatchConfig)

Sürekli eşleme modunu başlatmak için kullanılan yapılandırma.

ContinuousMatchConfig

Sürekli eşleme modunu başlatmak için kullanılan yapılandırma.

JSON gösterimi
{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}
Alanlar
expectedPhrases[]

object (ExpectedPhrase)

Bu sürekli eşleme modu oturumu sırasında olası tüm olası ifadeler.

durationSeconds

integer

Sürekli eşleme modunun açık tutulacağı süre. Belirtilirse süre dolduğunda mikrofon kapatılır. İzin verilen maksimum değer 180'dir.

ExpectedPhrase

JSON gösterimi
{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}
Alanlar
phrase

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ış algılanabilir. Bu, geliştiricilerin homofonlar için alternatif tetikleyiciler belirtmesine olanak tanır.

OrderUpdate

Bir siparişle güncelleyin.

JSON gösterimi
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Alanlar
type
(deprecated)

enum (Type)

Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. = SNAPSHOT türündeyse, OrderUpdate.order tüm sipariş olmalıdır. Tür = ORDER_STATUS ise bu, sipariş düzeyinde durum değişikliğidir. Yalnızca Order.last_update_time ve bu sektör/tema durumu alınır. Not: type.ORDER_STATUS, yalnızca Purcahase OrderExtension durum güncellemelerini destekler ve bu desteğin genişletilmesiyle ilgili bir plan yoktur. Bunun yerine, daha genel, genişletilebilir ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz.

order

object (Order)

updateMask

string (FieldMask format)

Not: Aşağıdaki özel alanlar için şu hususlar/öneriler geçerlidir: 1. order.last_update_time güncelleme isteğinin bir parçası olarak her zaman güncellenir. 2. order.create_time, order.google_order_id ve order.merchant_order_id gibi değerleri, updateMask kapsamında sağlanırsa yoksayılır.

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

userNotification

object (UserNotification)

Belirtilirse kullanıcıya, belirtilen başlık ve metinle bir bildirim görüntüler. Bir bildirimin belirtilmesi, bildirimde bulunulması önerilir ve bildirimle sonuçlanacağı garanti edilmez.

reason

string

Değişikliğin/güncellemenin nedeni.

Tür

Desteği sonlandırıldı: Bunun yerine OrderUpdate.update_mask değerini kullanın. Bir siparişte izin verilen güncellemeler.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi, bunu açık bir şekilde ayarlamamalıdır.
ORDER_STATUS Yalnızca siparişin durumunu günceller.
SNAPSHOT Sipariş anlık görüntüsünü güncelleyin.

Sipariş

Sipariş varlığı. Not: 1. Aksi belirtilmedikçe tüm düzeylerdeki tüm dizeler 1.000 karakterden kısa olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerdeki yinelenen tüm alanların sayısı 50'den az olmalıdır. 3. Belirtilmişse tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.

JSON gösterimi
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (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

Zorunlu: Satıcı tarafından atanan dahili sipariş kimliği. Bu kimlik benzersiz olmalıdır ve sonraki sipariş güncelleme işlemleri için gereklidir. Bu kimlik, sağlanan googleOrdersId veya başka bir benzersiz değere ayarlanabilir. Kullanıcılara sunulan kimlik, farklı ve daha kullanıcı dostu bir değer olan uservisible OrderId olabilir. İzin verilen maksimum uzunluk 128 karakterdir.

userVisibleOrderId

string

Geçerli siparişe referans veren kullanıcıya yönelik kimlik. Bu kimlik; web siteleri, uygulamalar ve e-posta dahil diğer bağlamlarda bu sipariş için görüntülenen kimlikle tutarlı olmalıdır.

userVisibleStateLabel
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine OrderExtensions durumunu kullanın. Bu siparişin durumu için kullanıcı tarafından görülebilen etiket.

buyerInfo

object (UserInfo)

Alıcıyla ilgili bilgiler.

image

object (Image)

Siparişle ilişkilendirilen resim.

createTime

string (Timestamp format)

Gerekli: Siparişin oluşturulduğu tarih ve saat.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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. OrderUpdate için gereklidir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 bir sağlayıcıdan farklı olabilir. Örnek: ANA'dan satır öğesi içeren Expedia Siparişi.

contents

object (Contents)

Gerekli: Bir satır öğesi grubu olan sipariş içerikleri.

priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler vb.

followUpActions[]

object (Action)

Sipariş düzeyinde takip işlemleri.

paymentData

object (PaymentData)

Siparişe ilişkin ödemeyle ilgili veriler.

termsOfServiceUrl

string

Sipariş/önerilen sipariş için geçerli olan hizmet şartlarının bağlantısı.

note

string

Bir siparişe notlar eklendi.

promotions[]

object (Promotion)

Bu siparişle ilişkili tüm promosyonlar.

disclosures[]

object (Disclosure)

Bu siparişle ilgili açıklamalar.

vertical
(deprecated)

object

Desteği sonlandırıldı: Bunun yerine sektörleri kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör türüyle eşleşmelidir. Muhtemel değerler: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

Birleştirme alanı verticals. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olacaktır. Bu sektör, satır öğesi seviyesindeki sektör türüyle eşleşmelidir. verticals şunlardan yalnızca biri olabilir:
purchase

object (PurchaseOrderExtension)

Satın alma siparişi

ticket

object (TicketOrderExtension)

Bilet siparişi

UserInfo

Kullanıcı hakkında bilgiler. Bu, bir siparişle ilişkili kullanıcıya ait bilgileri göstermek için kullanılır.

JSON gösterimi
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (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ı.

Telefon Numarası

Standart telefon numarası temsili.

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

string

Uluslararası Telekomünikasyon Birliği'nin (ITU) E.164 Önerisinde tanımlandığı şekilde E.164 biçiminde telefon numarası. wiki bağlantısı: https://en.wikipedia.org/wiki/E.164

extension

string

Maksimum 40 haneli bir sayı dizisi olarak tanımlananlar haricinde, ITU önerilerinde uzantı standartlaştırılmamıştır. Burada, uzantıda baştaki sıfırın olası kullanımına yer vermek için kullanılacak bir dize olarak tanımlanır (herhangi bir standart tanımlanmış olmadığından kuruluşlar bunu yapma konusunda tam özgürlüğe sahiptir). Rakamlar dışında, "," gibi diğer bazı karakterleri (beklemeyi belirten) burada saklanabilir. Örneğin, xxx-xxx-xxxx ext. 123, "123" uzantı.

preferredDomesticCarrierCode

string

Bu telefon numarası yurt içinde aranırken tercih edilen operatör seçim kodu. Buna, bazı ülkelerde sabit hatlardan cep telefonuna veya tam tersi hatlardan arama yaparken aranması gereken kodlar da dahildir. Örneğin, Columbia'da "3" bir cep telefonundan yerel bir sabit hat numarasına arama yaparken (veya tam tersi) telefon numarasından önce aranması gerekir. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Bunun "tercih edilen" olduğunu unutmayın diğer kodların da çalışabileceği anlamına gelir.

Resim

Kartta bir resim gösteriliyor.

JSON gösterimi
{
  "url": string,
  "accessibilityText": string,
  "height": integer,
  "width": integer
}
Alanlar
url

string

Resmin kaynak URL'si. Resimler JPG, PNG ve GIF biçiminde (animasyonlu veya 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 öğesinin 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 Ekmek")

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] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni.

formattedAddress

string

Görünen adres, ör. "Basın Sitesi Mahallesi, 215 Sokak, Karabağlar, İzmir 35150". [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] izni.

zipCode

string

Posta kodu. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni.

city

string

Şehir. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni.

postalAddress

object (PostalAddress)

Posta adresi. [DEVICE_PRECISE_LOCATION] gerekir [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] izni.

name

string

Yerin adı.

phoneNumber

string

Konumun telefon numarası, ör. işletme konumunun iletişim numarası veya teslimat yeri için 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 adresini ziyaret edin

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

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. veya ödeme adresleri için de geçerlidir. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.

Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi / düzenleme ile ilgili öneri: - https://github.com/google/libaddressinput gibi i18n özellikli bir adres widget'ı kullanın) - Kullanıcılara, alanın kullanıldığı ülkeler dışındaki alanların girilmesi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla yardım için lütfen bkz: https://support.google.com/business/answer/6397478

JSON gösterimi
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Alanlar
revision

integer

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0'a 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 durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek kullanıcıya bağlıdır. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: "CH" kullanmaya başladım.

languageCode

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 adreste kullanılan dillerden biriyle eşleşmesi beklenir ülke/bölge ya da harf çevirisi yapılmış eşdeğerleri. Bu, belirli ülkelerde biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir.

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".

postalCode

string

İsteğe bağlı. Adresin posta kodu. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir.

sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili).

administrativeArea

string

İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin, bu bir eyalet, il, oblast veya vilayet olabilir. Özellikle, İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmadan bırakılmalıdır.

locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada konumların iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, yerel ayarı boş bırakın ve addressLines kullanın.

sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir.

addressLines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

addressLines'taki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebildiğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası "zarf sırası" olmalıdır girin. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" ya da "en"). Bu şekilde, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode'dan oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar hiçbir adres bileşeni hakkında anlamsal çıkarımda bulunulamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri işlemek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine).

recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, ekleyebilirsiniz.

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 sektör içeriyor. Bir siparişte veya alışveriş sepetinde aynı sektörde birden fazla satır öğesi bulunabilir. Alt satır öğeleri/eklentiler vb., kullanım alanlarına bağlı olarak dikey protolarda tanımlanmalıdır. Not: 1. Aksi belirtilmedikçe tüm düzeylerdeki tüm dizeler 1.000 karakterden kısa olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerdeki yinelenen tüm alanların sayısı 50'den az olmalıdır. 3. Belirtilmişse tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.

JSON gösterimi
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (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üzey durumunu kullanın. Örneğin, satın alma işlemleri için Purchase OrderExtension.status ifadesini kullanın. Bu satır öğesinin durumu için kullanıcı tarafından görülebilen etiket.

provider

object (Merchant)

Belirli bir satır öğesinin sağlayıcısı (genel siparişten farklıysa). Örnek: Satır öğesi sağlayıcısı ANA'yı içeren Expedia Siparişi.

priceAttributes[]

object (PriceAttribute)

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

followUpActions[]

object (Action)

Satır öğesinde takip işlemleri.

recipients[]

object (UserInfo)

Satır öğesi düzeyindeki müşteriler. Bu, Sipariş düzeyinde alıcıdan farklı olabilir. Örnek: X kullanıcısı, Y kullanıcısı adına restoran rezervasyonu yapmıştır.

image

object (Image)

Bu öğeyle ilişkili küçük resim (varsa).

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 ilişkili açıklamalar.

vertical
(deprecated)

object

Desteği sonlandırıldı: Bunun yerine sektörleri kullanın. Gerekli: Türüne/sektörüne göre satır öğesinin Semantik İçeriği. Her sektör, kendi sipariş karşılama ayrıntılarını içermelidir. Şu değerlerden biri olmalıdır: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

Birleştirme alanı verticals. Gerekli: Türüne/sektörüne göre satır öğesinin Semantik İçeriği. Her sektör, kendi sipariş karşılama ayrıntılarını içermelidir. verticals şunlardan yalnızca biri olabilir:
purchase

object (PurchaseItemExtension)

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

reservation

object (ReservationItemExtension)

Restoran, saç kesimi vb. 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)

Zorunlu: Para özelliğinin türü.

name

string

Zorunlu: Fiyat özelliğinin kullanıcı tarafından gösterilen dizesi. Bu bilgi satıcı tarafından gönderilir ve yerelleştirilir.

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: Tahmini ve Gerçekleşen.

taxIncluded

boolean

Fiyata vergi dahil olup olmadığı.

Birleştirme alanı spec. Parasal tutarı veya milisaniye cinsinden yüzdeyi temsil eder. spec şunlardan yalnızca biri olabilir:
amount

object (Money)

Para tutarı.

amountMillipercentage
(deprecated)

integer

Yüzdenin 1/1000'i oranında yüzde spesifikasyonu. Ör. %8, 750 8750 olarak temsil edilir; negatif yüzdeler ise yüzdelik indirimleri temsil eder. Bu alan kullanımdan kaldırılıyor. Sağlam bir kullanım alanı gerektiğinde tekrar eklemeyi düşünebilirsiniz.

Tür

Para türünü gösterir.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi. İstemcilerin bunu açık bir şekilde ayarlaması gerekmez.
REGULAR Herhangi bir indirim vb. uygulanmadan önceki normal görünen fiyat.
DISCOUNT Ara toplamdan çıkarılacak.
TAX Ara toplama eklenecek.
DELIVERY Ara toplama eklenecek.
SUBTOTAL Bazı ücretler eklenmeden önceki ara toplam.
FEE Ek Ücretler.
GRATUITY Ara toplama eklenecek.
TOTAL Siparişin veya satır öğesinin gösterilen fiyatı.

Eyalet

Fiyat durumunu gösterir.

Sıralamalar
STATE_UNSPECIFIED Belirtilmedi.
ESTIMATE Fiyat yalnızca tahmini bir değerdir ancak nihai tutar bu tutara yakındır. Örnek: İşlem sırasında verginin doğru bir şekilde bilinmediği durumlarda toplam tutar ESTIMATE olur.
ACTUAL Kullanıcı için alınacak gerçek fiyat.

Para

Para birimi türüyle birlikte bir para tutarını gösterir.

JSON gösterimi
{
  "currencyCode": string,
  "amountInMicros": string
}
Alanlar
currencyCode

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 takip işlemi.

JSON gösterimi
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Alanlar
type

enum (Type)

Zorunlu: İşlem türü

title

string

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

openUrlAction

object (OpenUrlAction)

Yapılacak 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üle işlemi.
MODIFY Sipariş işlemini değiştirme işlemi.
CANCEL Siparişi iptal etme işlemi.
RETURN Sipariş iadesi işlemi.
EXCHANGE Exchange sipariş işlemi.
EMAIL

E-posta işlemi. EMAIL ve CALL türleri kullanımdan kaldırıldı. openUrlAction.url, telefon numarası veya e-posta olarak kullanılabilir.

CALL

Arama işlemi.

REORDER İşlemi yeniden sıralayın.
REVIEW Sipariş işlemini inceleyin.
CUSTOMER_SERVICE Müşteri hizmetleriyle iletişime geçin.
FIX_ISSUE Sorunu düzeltmek için satıcı sitesine veya uygulamasına yönlendirin.
DIRECTION Yol tarifi bağlantısı.

OpenUrlAction

Belirtilen URL'yi açar.

JSON gösterimi
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Alanlar
url

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulamaya bağlı bir uygulamayı veya web sayfasını açmak için http/https urls

androidApp

object (AndroidApp)

URL'nin bir Android uygulaması tarafından yerine getirilmesi bekleniyorsa Android Uygulaması hakkında bilgiler.

urlTypeHint

enum (UrlTypeHint)

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

AndroidApp

Sipariş karşılama kısıtlamalarıyla ilgili Android uygulaması spesifikasyonu

JSON gösterimi
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Alanlar
packageName

string

Paket adı Android Sipariş Karşılaması belirtilirken Paket adı belirtilmelidir.

versions[]

object (VersionFilter)

Birden fazla filtre belirtildiğinde, herhangi bir filtre eşleşmesi uygulamayı tetikler.

VersionFilter

Uygulamanın belirli sürümleri gerekiyorsa VersionFilter eklenmelidir.

JSON gösterimi
{
  "minVersion": integer,
  "maxVersion": integer
}
Alanlar
minVersion

integer

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

maxVersion

integer

Maksimum sürüm kodu (bu değerler dahil). Dikkate alınan aralık: [minVersion:maxVersion]. Boş aralık, herhangi bir sürümü belirtir. Örnekler: Tek bir sürüm belirtmek için şunu kullanın: [target_version:target_version]. Herhangi bir sürümü belirtmek için minVersion ve maxVersion belirtilerini belirtmeden bırakın. maxVersion tarihine kadar tüm sürümleri belirtmek için minVersion değerini belirtmeden bırakın. minVersion sürümündeki tüm sürümleri belirtmek için maxVersion değerini belirtmeden bırakın.

UrlTypeHint

Farklı URL ipuçları türleri.

Sıralamalar
URL_TYPE_HINT_UNSPECIFIED Belirtilmedi
AMP_CONTENT Doğrudan AMP içeriğine veya <link rel="amphtml"> aracılığıyla AMP içeriğine başvuruda bulunan standart URL'ye yönlendiren URL.

ActionMetadata

İşlem başına ilgili meta veri.

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

string (Timestamp format)

Bu işlemin süresinin dolacağı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Açıklama

Kullanıcıya sunulabilecek ü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 veriliyor.

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

"{0}" gibi yer tutucular içeren, görüntülenecek metin ve "{1}" eklemeniz gerekir. Örnek: "UYARI: Bu ürün sizi kansere neden olduğu Kaliforniya Eyaleti tarafından bilinen kimyasallara maruz bırakabilir. Daha fazla bilgi için {0}" bölümüne gidin. Bu açıklama metni, tanıtım amaçlı veya reklam benzeri herhangi bir içerik barındırmamalıdır.

DisclosurePresentationOptions

Açıklama sunma seçenekleri.

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ğini belirler. Varsayılan olarak, başlangıçta daraltılmış durumdadır.

PresentationRequirement

Açıklamanın sunulması için şartlar.

Sıralamalar
REQUIREMENT_UNSPECIFIED Koşul belirtilmedi. Bu ayar açık bir şekilde yapılmamalıdır.
REQUIREMENT_OPTIONAL Açıklama isteğe bağlıdır. Cihaz, açıklamaları göstermeyi desteklemiyorsa bu adım atlanabilir.
REQUIREMENT_REQUIRED Açıklama zorunludur. Cihaz, açıklamaları göstermeyi desteklemiyorsa görüşme telefona yönlendirilir.

PurchaseItemExtension

Satın Alma Sektörünün satır öğesi içeriği.

JSON gösterimi
{
  "status": enum (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üzeyi durumu.

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

Zorunlu: 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 birimlerdeki öğenin boyutunu belirtir. Boyut, etkin fiyatla birlikte birim fiyatı belirlemek için kullanılır.

returnsInfo

object (PurchaseReturnsInfo)

Bu satır öğesinin bilgilerini döndürür. Politika ayarlanmazsa bu satır öğesi, sipariş düzeyinde döndürme bilgilerini devralır.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Bu satır öğesinin 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 aktarılan tüm ek alanlar. Not: Bu uzantının kullanılması hiçbir şekilde önerilmez. Kullanım alanına/duruma bağlı olarak aşağıdakilerden birini düşünün: 1. Diğer kullanım alanları (ör. genel özellik/işlev) için kullanılabilecekse PurchaseItemExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension değerini kullanın.

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

PurchaseStatus

Bir satın alma siparişiyle veya belirli bir satır öğesiyle ilişkili satın alma durumu.

Sıralamalar
PURCHASE_STATUS_UNSPECIFIED Durum belirtilmedi.
READY_FOR_PICKUP Teslim alma için hazır.
SHIPPED Gönderildi.
DELIVERED Teslim edildi.
OUT_OF_STOCK Stokta yok.
IN_PREPARATION "IN_PREPARATION" farklı bağlamda farklı anlamlar taşıyabilir. YİYECEK siparişi için, yemek hazırlanıyor olabilir. Perakende satış açısından ise bir öğe paketleniyor olabilir.
CREATED Sipariş oluşturuldu.
CONFIRMED Satıcı siparişi onayladı.
REJECTED Satıcı siparişi veya satır öğesini reddetti.
RETURNED Öğe, kullanıcı tarafından iade edildi.
CANCELLED Sipariş veya satır öğesi kullanıcı tarafından iptal edildi.
CHANGE_REQUESTED Kullanıcı siparişte bir değişiklik isteğinde bulundu ve entegrasyon uzmanı bu değişikliği işliyor. İstek işlendikten sonra siparişin başka bir duruma taşınması gerekir.

PurchaseType

Satın alma kategorisi.

Sıralamalar
PURCHASE_TYPE_UNSPECIFIED Bilinmeyen değer.
RETAIL Fiziksel ürünler gibi satın alma işlemlerini içerir.
FOOD Buna yemek siparişi satın alma da dahildir.
GROCERY Market alışverişi.
MOBILE_RECHARGE Ön ödemeli mobil para yükleme satın alma işlemi.

MerchantUnitMeasure

Satıcının birim fiyatlandırma ölçüsü.

JSON gösterimi
{
  "measure": number,
  "unit": enum (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) ise, döndürmeye izin verilir.

daysToReturn

integer

Bu sayıda gün içinde iade yapılabilir.

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)

Zorunlu: İstek karşılama türü.

expectedFulfillmentTime

object (Time)

Bir zaman aralığı belirtilmişse bir pencere, tek bir zaman belirtilmişse TVS. Beklenen teslimat veya teslim alma zamanı.

expectedPreparationTime

object (Time)

Bir zaman aralığı belirtilmişse bir pencere, tek bir zaman belirtilmişse TVS. Yemeği hazırlaması için beklenen süre. Tek seferlik tercih edilir.

location

object (Location)

Teslim alma veya teslimat konumu.

expireTime

string (Timestamp format)

Bu sipariş karşılama seçeneğinin süresinin dolacağı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 sipariş karşılamayla ilgili kullanıcı iletişim bilgileri.

shippingMethodName

string

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

storeCode

string

Konumun mağaza kodu. Örnek: Walmart satıcıyı, storeCode ise sipariş karşılamanın gerçekleştiği Walmart mağazasıdır. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Siparişin nasıl seçileceğiyle ilgili ek bilgi. Bu alan yalnızca sipariş karşılama türü TESLİM ALIN ise kullanılabilir.

Tür

Sipariş karşılama türü.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi.
DELIVERY Bu sipariş teslim edilecek.
PICKUP Bu siparişin teslim alınması gerekiyor.

Saat

Kullanıcıya sipariş gösterilirken kullanılacak etkinliğin zamanını temsil eden zaman yapısı.

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

string

Rezervasyon saati, teslimat zamanı vb. bir sipariş etkinliği zamanını gösterir. Bir süre (başlangıç ve bitiş saati), yalnızca tarih, tarih ve saat gibi bir bilgi olabilir. Desteklenen tüm biçimler için https://en.wikipedia.org/wiki/ISO_8601 sayfasına bakın.

PickupInfo

Siparişin nasıl teslim alındığıyla ilgili ayrıntılar. Bu raporda, teslim alma türü ve varsa her türle ilişkili ek meta veriler gibi ayrıntılar yer alır.

JSON gösterimi
{
  "pickupType": enum (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)

Check-in desteği sunmak için iş ortağı tarafından desteklenen çeşitli yöntemlerin listesi.

PickupType

Desteklenen teslim alma türlerinin listesi.

Sıralamalar
UNSPECIFIED Teslim alma türü belirtilmedi.
INSTORE Yemekleri restoranın içinde almak.
CURBSIDE Aracı restoranın dışında belirli bir yere park ederseniz bir kişi oraya yemek siparişi verecektir.

CurbsideInfo

Arabaya teslim alma siparişinin nasıl kolaylaştırılacağıyla ilgili ayrıntılar.

JSON gösterimi
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Alanlar
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

İş ortaklarının, arabaya teslim alma siparişlerini kolaylaştırmak için ek bilgiye ihtiyacı vardır. Seçilen sipariş karşılama türüne bağlı olarak ilgili ayrıntılar kullanıcıdan toplanır.

userVehicle

object (Vehicle)

Sipariş veren kullanıcının araç bilgileri.

CurbsideFulfillmentType

Arabaya teslim alma türlerinin olası değerleri.

Sıralamalar
UNSPECIFIED Arabaya teslim alma türü belirtilmedi.
VEHICLE_DETAIL Arabaya teslim almayı kolaylaştırmak için araç bilgileri gereklidir.

Araç

Bir araçla ilgili ayrıntılar

JSON gösterimi
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Alanlar
make

string

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

model

string

Araç modeli (ör. "Grom"). Bu bilgi, kullanıcıya gösterilir ve yerelleştirilmesi gerekir. 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 kontrol yöntemini desteklemek için iş ortağının ihtiyaç duyduğu meta veriler.

JSON gösterimi
{
  "checkInType": enum (CheckInType)
}
Alanlar
checkInType

enum (CheckInType)

Giriş talimatlarını göndermek için kullanılan yöntem.

CheckInType

Giriş talimatlarını göndermek için kullanılan çeşitli yöntemler.

Sıralamalar
CHECK_IN_TYPE_UNSPECIFIED Bilinmeyen değer.
EMAIL CheckIn bilgileri e-postayla gönderilir.
SMS CheckIn bilgileri SMS ile gönderilir.

ItemOption

Eklentileri veya alt öğeleri temsil eder.

JSON gösterimi
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (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 kullanılır.

ProductDetails

Ürünle ilgili ayrıntılar.

JSON gösterimi
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Alanlar
productId

string

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

gtin

string

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

plu

string

Genellikle PLU kodları, PLU numaraları, PLU'lar, ürün kodları veya ürün etiketleri olarak adlandırılan fiyat arama kodları, marketlerde ve süpermarketlerde satılan toplu ürünleri benzersiz şekilde tanımlayan bir sayı sistemidir.

productType

string

Satıcı tarafından tanımlanan ürün kategorisi. Ör. "Ana Sayfa > Market > Süt Ürünleri ve Yumurtalar > Süt > Tam Yağlı Süt"

productAttributes

map (key: string, value: string)

Ürün hakkında satıcı tarafından sağlanan bilgiler (ör. { &quot;allergen&quot;: &quot;peanut&quot; } tıklayın. OfferId değeri Merchant Center'da mevcut değilse kullanışlı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çeriği.

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 ayarlanmamış olabilir.

reservationTime

object (Time)

Hizmetin/etkinliğin planlandığı saat. Zaman aralığı, tarih veya kesin bir tarih saat olabilir.

userAcceptableTimeRange

object (Time)

Kullanıcı için kabul edilebilir zaman aralığı.

confirmationCode

string

Bu rezervasyon için onay kodu.

partySize

integer

Kişi sayısı.

staffFacilitators[]

object (StaffFacilitator)

Rezervasyonla ilgilenecek olan personel moderatörleri. Ör. Kuaför.

location

object (Location)

Hizmetin/etkinliğin konumu.

ReservationStatus

Rezervasyonun durumu.

Sıralamalar
RESERVATION_STATUS_UNSPECIFIED Belirtilmemiş durum.
PENDING Rezervasyon beklemede.
CONFIRMED Rezervasyon onaylandı.
CANCELLED Rezervasyon kullanıcı tarafından iptal edildi.
FULFILLED Rezervasyon tamamlandı.
CHANGE_REQUESTED Rezervasyon değişikliği istendi
REJECTED Rezervasyonun süresi doldu veya entegratör tarafından reddedildi.

ReservationType

Rezervasyon türü.

Sıralamalar
RESERVATION_TYPE_UNSPECIFIED Tür belirtilmedi.
RESTAURANT Restoran rezervasyonu.
HAIRDRESSER Kuaför rezervasyonu.

StaffFacilitator

Hizmet veren kişi hakkında bilgi.

JSON gösterimi
{
  "name": string,
  "image": {
    object (Image)
  }
}
Alanlar
name

string

Personel yöneticisinin 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)

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu. Ödeme deneyimi Actions-on-Google tarafından yönetiliyorsa bu alan Actions on Google tarafından doldurulur.

paymentInfo

object (PaymentInfo)

Siparişle ilgili, kullanıcıların gördüğü etkileşimlerde faydalı olan ödeme bilgileri.

PaymentResult

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu.

JSON gösterimi
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Alanlar
Birleştirme alanı result. Google ödeme verileri veya satıcı ödeme yöntemi sağlanır. result şunlardan yalnızca biri olabilir:
googlePaymentData

string

Google tarafından sağlanan ödeme yöntemi verileri. Ödeme işleyiciniz şu adreste Google tarafından desteklenen ödeme işleyici olarak listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla bilgi edinmek için bağlantıyı kullanarak ödeme işleyicinize gidin. Aksi takdirde yük ayrıntıları için aşağıdaki belgelere bakın. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Kullanıcı tarafından seçilen satıcı/işlem tarafından sağlanan ödeme yöntemi.

PaymentInfo

Verilen siparişle ilgili ödeme bilgileri. Bu protokol, kullanıcılara yönelik etkileşim için yararlı olan bilgileri yakalar.

JSON gösterimi
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Alanlar
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

İşlem için kullanılan ödeme yöntemiyle ilgili gösterilen bilgiler.

paymentMethodProvenance

enum (PaymentMethodProvenance)

İşlem için kullanılan ödeme yönteminin kaynağı. Kullanıcı, aynı ödeme yöntemini hem Google'da hem de satıcıda kaydetmiş olabilir.

PaymentMethodDisplayInfo

Bir işlemi tamamlamak için entegrasyon uzmanı tarafından kullanılan ödeme sonucu.

JSON gösterimi
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Alanlar
paymentType

enum (PaymentType)

Ödemenin türü.

paymentMethodDisplayName

string

Ödeme yönteminin kullanıcı tarafından görülebilen adı. Örneğin, VISA **** 1234 Çek hesabı **** 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 "beş altı yedi sekiz ile biten çek hesabı". Not: Bu, yalnızca ses özellikli asistan cihazlarında paymentMethodDisplayName yerine kullanılacak sesle optimize edilmiş dizedir. Bu dize ayarlanmazsa ödemeMethodDisplayName kullanıcıya söylenir.

PaymentType

PaymentType, satıcı tarafından sağlanan ödeme yöntemi için kullanılan ödeme şeklini gösterir. İşlem, ödeme yöntemi için bir görünen ad da sağlamalıdır.

Sıralamalar
PAYMENT_TYPE_UNSPECIFIED Ödeme türü belirtilmedi.
PAYMENT_CARD Kredi kartı/banka kartı veya ön ödemeli kart.
BANK Ödeme yöntemi bir banka hesabıdır.
LOYALTY_PROGRAM Ödeme yöntemi bir bağlılık programıdır.
CASH Ödeme yöntemi nakit olarak yapılır.
GIFT_CARD Ödeme yöntemi bir hediye kartıdır.
WALLET Üçüncü taraf cüzdan (ör. PayPal)

PaymentMethodProvenance

İşlem için kullanılan ödeme yöntemi kaynağını gösterir.

Sıralamalar
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Kaynak Belirtilmemiş.
PAYMENT_METHOD_PROVENANCE_GOOGLE Kaynak Google'dır.
PAYMENT_METHOD_PROVENANCE_MERCHANT Köken Satıcıdır.

Tanıtım

Alışveriş sepetine eklenen promosyonlar/teklifler.

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

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ıkça 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)

Zorunlu: Satın alma türü.

returnsInfo

object (PurchaseReturnsInfo)

Siparişle ilgili iade bilgileri.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Siparişin sipariş karşılama bilgileri.

purchaseLocationType

enum (PurchaseLocationType)

Satın alma yeri (mağazada / internette)

errors[]

object (PurchaseError)

İsteğe bağlı: Bu siparişin reddedilmesine neden olan hatalar.

extension
(deprecated)

object

Satıcı ile Google arasında aktarılan tüm ek alanlar. Not: Bu uzantının kullanılması hiçbir şekilde önerilmez. Kullanım alanına/duruma bağlı olarak aşağıdakilerden birini düşünün: 1. Diğer kullanım alanları (ör. genel özellik/işlev) için kullanılabilecekse Purchase OrderExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension değerini kullanın.

Rastgele türden alanlar içeren nesne. Ek bir "@type" alanı, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

PurchaseLocationType

Satın alma işleminin bulunduğu konum türü.

Sıralamalar
UNSPECIFIED_LOCATION Bilinmeyen değer.
ONLINE_PURCHASE Tüm satın alma işlemleri çevrimiçi olarak satın alındı.
INSTORE_PURCHASE Tüm mağaza içi satın alma işlemleri.

PurchaseError

Satın alma siparişinin reddedilebileceği hatalar.

JSON gösterimi
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Alanlar
type

enum (ErrorType)

Gerekli: Bu, bir siparişin satıcı tarafından reddedilme nedenini ayrıntılı olarak gösterir.

description

string

Ek hata açıklaması.

entityId

string

Hataya karşılık gelen varlık kimliği. Örnek, bunun LineItemId / ItemOptionId öğesine karşılık gelebilir.

updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE hata türünde geçerlidir.

availableQuantity

integer

Kullanılabilir miktar. AVAILABILITY_CHANGED durumunda geçerlidir.

ErrorType

Olası hata türleri.

Sıralamalar
ERROR_TYPE_UNSPECIFIED Bilinmeyen hata
NOT_FOUND Öğe bulunamadı. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği zorunludur.
INVALID Varlık verileri geçerli değil. Öğe, Sipariş karşılama, Tanıtım olabilir. Varlık kimliği zorunludur.
AVAILABILITY_CHANGED Öğe mevcut değil veya isteği yerine getirmek için yetersiz. Varlık kimliği zorunludur.
PRICE_CHANGED Öğe fiyatı, öğe varlığındaki fiyattan farklı. Varlık kimliği ve güncellenmiş fiyat gerekir.
INCORRECT_PRICE Ücretler, Toplam fiyat hataları. Varlık kimliği ve güncellenmiş fiyat gerekir.
REQUIREMENTS_NOT_MET Sipariş kabuliyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.).
TOO_LATE FulfillmentOption'ın süresi doldu.
NO_CAPACITY Kullanılabilir hizmet kapasitesi yok. Daha ayrıntılı hata türlerinden hiçbiri geçerli değilse bu hata kodunu kullanın.
NO_COURIER_AVAILABLE Teslimat kuryesi bulunamadı. NO_CAPACITY olarak sınıflandırılabilen ayrıntılı bir hata türü.
INELIGIBLE Kullanıcı sipariş vermeye uygun değil (kara listede).
OUT_OF_SERVICE_AREA Sınır kuralları vb. nedeniyle istenen adrese teslim edilemedi.
CLOSED Restoran, sipariş saatinde çalışma nedeniyle kapalıdır.
PROMO_NOT_APPLICABLE Aşağıdakilerin hiçbiri uygun değilse, promosyon kodu uygulanamadı tüm durumları yakalamak için kullanılan genel hata kodu. Promosyon kodunu Varlık Kimliği olarak ekleyin.
PROMO_NOT_RECOGNIZED Kupon kodu, iş ortağı tarafından tanınmadı. Promosyon kodunu Varlık Kimliği olarak ekleyin.
PROMO_EXPIRED Promosyonun süresi dolduğundan uygulanamadı. Promosyon kodunu Varlık Kimliği olarak ekleyin.
PROMO_USER_INELIGIBLE Geçerli kullanıcı bu kuponu almak için uygun değil. Promosyon kodunu Varlık Kimliği olarak ekleyin.
PROMO_ORDER_INELIGIBLE Geçerli sipariş bu kupon için uygun değil. Promosyon kodunu Varlık Kimliği olarak ekleyin.
UNAVAILABLE_SLOT Önceden sipariş aralığı kullanılamıyor.
FAILED_PRECONDITION Sipariş kabuliyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.)
PAYMENT_DECLINED Geçersiz ödeme.
MERCHANT_UNREACHABLE Satıcıya ulaşılamıyor. Bu, bir iş ortağının toplayıcı olmasına rağmen satıcıya ulaşamadığı durumlarda yardımcı olur.
ACCOUNT_LINKING_FAILED Satıcı, kullanıcının Google hesabını sistemindeki bir hesaba bağlamaya çalıştı ancak bunu yaparken bir hatayla karşılaştı.

TicketOrderExtension

Film, spor vb. bilet siparişlerinin içeriği

JSON gösterimi
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Alanlar
ticketEvent

object (TicketEvent)

Tüm satır öğesi biletlerine uygulanan etkinlik.

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)

Zorunlu: Bilet etkinliğinin türü, ör. film, konser.

name

string

Zorunlu: Etkinliğin adı. Örneğin, etkinlik bir filmse bu film adı olmalıdır.

description

string

Etkinliğin açıklaması.

url

string

Etkinlik bilgisinin URL'si.

location

object (Location)

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

eventCharacters[]

object (EventCharacter)

Bu etkinlikle ilgili karakterler. Bir film etkinliğinin yönetmenleri veya oyuncuları ya da bir konserin performansları vb. olabilir.

startDate

object (Time)

Başlangıç zamanı.

endDate

object (Time)

Bitiş zamanı.

doorTime

object (Time)

Giriş saati. Bu saat, etkinlik başlangıç zamanından farklı olabilir. ör. Etkinlik sabah 9'da başlıyor, ancak giriş saati 08:30.

Tür

Etkinliğin türü.

Sıralamalar
EVENT_TYPE_UNKNOWN Bilinmeyen etkinlik türü.
MOVIE Film.
CONCERT Konser.
SPORTS Spor.

EventCharacter

Bir etkinlik karakteri, ör. düzenleyen, sanatçı vb.

JSON gösterimi
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Alanlar
type

enum (Type)

Etkinlik karakterinin türü, ör. oyuncu ya da yönetmen.

name

string

Karakterin adı.

image

object (Image)

Karakterin resimleri.

Tür

Karakter türü.

Sıralamalar
TYPE_UNKNOWN Bilinmeyen tür.
ACTOR İşlemi gerçekleştiren.
PERFORMER Performans uzmanı.
DIRECTOR Yönetmen.
ORGANIZER Düzenleyen.

UserNotification

Sipariş güncellemesinin bir parçası olarak gösterilecek isteğe bağlı kullanıcı bildirimi.

JSON gösterimi
{
  "title": string,
  "text": string
}
Alanlar
title

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

Sonraki yürütülecek sahneyi gösterir.

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

string

Sonraki yürütülecek sahnenin adı.

Oturum

Mevcut sohbet oturumuyla ilgili bilgiler içerir

JSON gösterimi
{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}
Alanlar
id

string

Zorunlu. Geçerli 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. Null değerine sahip parametreler oturumdan kaldırılır. Oturum depolama dokümanlarını şu adreste bulabilirsiniz: https://developers.google.com/assistant/conversational/storage-session.

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

typeOverrides[]

object (TypeOverride)

İsteğe bağlı. Oturumun kapsamında olan türler. Tanımladığı oturum türü, mevcut türleri destekleyebilir veya değiştirebilir. Tür adları benzersiz olmalıdır.

languageCode

string

Geçerli sohbet oturumunun dili. IETF BCP-47 dil kodunu (http://www.rfc-editor.org/rfc/bcp/bcp47.txt) izler. İşlem birden fazla dil özelliğini kullanıyorsa bu, kullanıcının yerel ayarından farklı olabilir. Örneğin, işleyici_yanıtı.beklenen.dil_kodu ayarlandığında sonraki tüm dönüşler için sohbet dilini değiştirir ve bu işlem bu alana yansıtılır.

TypeOverride

Bir tür için geçersiz kılmayı temsil eder.

JSON gösterimi
{
  "name": string,
  "mode": enum (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ştirilmesi gerektiği.

synonym

object (SynonymType)

TypeOverrideMode

Oturum öğe türündeki değişikliklerin türleri.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmedi. Bu değer hiçbir zaman kullanılmamalıdır.
TYPE_REPLACE Bu yanıttaki tür tanımları, daha önce tanımlanan tür tanımlarının yerini alacak.
TYPE_MERGE Bu yanıttaki tür tanımları, daha önce tanımlanan tür tanımlarıyla birleştirilir. Yeni tür tanımları, mevcut tür tanımlarının üzerine yazılır.

SynonymType

Eş anlamlılar içeren bir türü gösterir.

JSON gösterimi
{
  "entries": [
    {
      object (Entry)
    }
  ]
}
Alanlar
entries[]

object (Entry)

Zorunlu. Eş anlamlı türü girişlerinin listesi.

Giriş

Eş anlamlı bir tür girişi temsil eder.

JSON gösterimi
{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}
Alanlar
name

string

Zorunlu. Girişin adı (ör. "bisiklet"). Bu alandaki girişin, geçerli bir tür değeri olarak tanınabilmesi için tekrarlanan eş anlamlılar alanına eklenmesi gerekir.

synonyms[]

string

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

display

object (EntryDisplay)

İsteğe bağlı. Öğeyle ilgili bilgiler gösterilir.

EntryDisplay

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

string

Zorunlu. Öğenin başlığı. Bu metin dokunulduğunda, kullanıcı yazmış gibi görüşmede olduğu gibi yayınlanır. Her başlık, koleksiyon öğeleri grubu içinde benzersiz olmalıdır.

description

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

openUrl

object (OpenUrl)

Göz atma bandı öğesiyle ilişkili dokümanın URL'si. Banda göz atmak için gereklidir.

Kullanıcı

İşlem için istekte bulunan kullanıcıyı temsil eder.

JSON gösterimi
{
  "locale": string,
  "params": {
    string: value,
    ...
  },
  "accountLinkingStatus": enum (AccountLinkingStatus),
  "verificationStatus": enum (UserVerificationStatus),
  "lastSeenTime": string,
  "engagement": {
    object (Engagement)
  },
  "packageEntitlements": [
    {
      object (PackageEntitlements)
    }
  ],
  "permissions": [
    enum (Permission)
  ]
}
Alanlar
locale

string

İstekte bulunan kullanıcının birincil yerel ayarı. IETF BCP-47 dil kodunu (http://www.rfc-editor.org/rfc/bcp/bcp47.txt) izler. Ancak komut dosyası alt etiketi dahil edilmez.

params

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ını şu adreste bulabilirsiniz: 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 son etkileşimin zaman damgası. Kullanıcı daha önce temsilciyle etkileşimde bulunmadıysa bu alan atlanır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

engagement

object (Engagement)

Amaca yönelik tüm abonelikler de dahil olmak üzere geçerli 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ı tarafından bu İşlem için verilen izinleri içerir.

AccountLinkingStatus

Son kullanıcının hesabını bu uygulamaya bağlayıp bağlamadığını belirtir. Hesap bağlama belgelerine bakın: https://developers.google.com/assistant/identity.

Sıralamalar
ACCOUNT_LINKING_STATUS_UNSPECIFIED Bilinmiyor.
NOT_LINKED Kullanıcı, hesabını bu uygulamaya bağlamadı.
LINKED Kullanıcı, hesabını bu uygulamaya bağladı.

UserVerificationStatus

Google'ın kullanıcıyı doğrulayıp doğrulamadığını belirtir. DOĞRULANDI durumu, parametreler alanını kullanarak veya hesap bağlama yoluyla verileri görüşmeler arasında kaydedebileceğinizi belirtir.

Sıralamalar
USER_VERIFICATION_STATUS_UNSPECIFIED Bilinmiyor.
GUEST Misafir kullanıcı.
VERIFIED Doğrulanmış kullanıcı.

Etkileşim

Geçerli kullanıcının hangi etkileşim mekanizmalarına kaydolduğu hakkında salt okunur ek bilgiler sağlar. Örneğin, kullanıcının tekrar aynı amaca abone olmasını istememek için hangi amaçlara abone olduğunu bilmek yararlı olabilir. Diğer bir deyişle, bu bilgiler yalnızca kullanıcı henüz abone olmadıysa DailyUpdates veya PushBildirimleri ayarlamak üzere bir sahneye koşullu olarak yönlendirme yapmak için kullanılabilir. Kullanıcı etkileşimi belgelerini inceleyin: https://developers.google.com/assistant/engagement.

JSON gösterimi
{
  "pushNotificationIntents": [
    {
      object (IntentSubscription)
    }
  ],
  "dailyUpdateIntents": [
    {
      object (IntentSubscription)
    }
  ]
}
Alanlar
pushNotificationIntents[]

object (IntentSubscription)

Kullanıcının push bildirimini 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 tanımlar.

JSON gösterimi
{
  "intent": string,
  "contentTitle": string
}
Alanlar
intent

string

Abone olunan amacın adı.

contentTitle

string

Aboneliğin kısa bir açıklaması. Bu ad, bildirimin etiketi olarak ve Asistan kullanıcıdan izin istediğinde kullanılır.

PackageEntitlements

Kullanıcının bir paket adıyla ilgili haklarının listesi. Dijital iyi işlem belgelerini şu adreste bulabilirsiniz: https://developers.google.com/assistant/transactions/digital/dev-guide-digital-non-consumables.

JSON gösterimi
{
  "packageName": string,
  "entitlements": [
    {
      object (Entitlement)
    }
  ]
}
Alanlar
packageName

string

İşlem paketinde belirtilen Android paketi adı.

entitlements[]

object (Entitlement)

Kullanıcının belirtilen paketten yararlanma hakları.

Hak

Kullanıcının dijital haklarını tanımlar.

JSON gösterimi
{
  "sku": string,
  "skuType": enum (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 işlemleri ve uygulama içi aboneler için geçerlidir.

SkuType

Sıralamalar
SKU_TYPE_UNSPECIFIED
IN_APP Uygulama içi satın alma
SUBSCRIPTION Abonelikler
APP Ücretli uygulamalar

SignedData

JSON gösterimi
{
  "inAppPurchaseData": {
    object
  },
  "inAppDataSignature": string
}
Alanlar
inAppPurchaseData

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 6. tabloda bulabilirsiniz.

inAppDataSignature

string

Play InApp Faturalandırma API'sinde getPurchases() yönteminden IN_APP_DATA_SIGNATURE ile eşleşir.

İzin

İzin için olası değerler.

Sıralamalar
PERMISSION_UNSPECIFIED Belirtilmemiş izin.
DEVICE_PRECISE_LOCATION Kullanıcının tam konumunu, enlem/boylamını ve biçimlendirilmiş adresini isteyin.
DEVICE_COARSE_LOCATION Kullanıcının yaklaşık konumunu, posta kodunu, şehir ve ülke kodunu isteyin.
UPDATE Güncelleme göndermek için izin isteyin. https://developers.google.com/assistant/engagement/daily adresini ziyaret edin.

Ana Sayfa

Kullanıcının hedef cihazının ait olduğu HomeGraph yapısını gösterir.

JSON gösterimi
{
  "params": {
    string: value,
    ...
  }
}
Alanlar
params

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

İsteğe bağlı. Hedef cihazın ait olduğu HomeGraph yapısıyla ilişkili parametrelerin listesi. Ev depolama alanı dokümanlarını şu adreste bulabilirsiniz: https://developers.google.com/assistant/conversational/storage-home.

"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ı gösterir.

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

enum (Capability)

Zorunludur. cihazın İşlem için istekte bulunma ö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 doldurulacağını unutmayın. Hangi alanların genel veya ayrıntılı izinlere göre ayarlandığı hakkında daha fazla bilgi için konum mesajına bakın. İzin belgelerine bakın: https://developers.google.com/assistant/conversational/permissions.

timeZone

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 üzerinden kullanıcıyla konuşabilir.
RICH_RESPONSE Cihaz; kartlar, listeler ve tablolar gibi zengin yanıtları görüntüleyebilir.
LONG_FORM_AUDIO Cihaz, müzik ve podcast gibi uzun biçimli sesli medyaları oynatabilir.
INTERACTIVE_CANVAS Cihazda etkileşimli bir tuval yanıtı gösterilebilir.
HOME_STORAGE Cihaz, ev depolama alanının kaydedilmesini ve getirilmesini 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ı gerekir. Tam konum izni, "administrativeArea" gibi ek alanları doldurur ve "addressLines".

TimeZone

IANA Saat Dilimi Veritabanı'ndan bir saat dilimini temsil eder.

JSON gösterimi
{
  "id": string,
  "version": string
}
Alanlar
id

string

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

version

string

İsteğe bağlı. IANA Saat Dilimi Veritabanı sürüm numarası, ör. "2019a".

Bağlam

Kullanıcı sorgu yaptığında bağlam bilgilerini içerir. Etkin medya oturumu, tuval web uygulamasının durumu vb. hakkındaki bilgiler bu kapsamda değerlendirilir.

JSON gösterimi
{
  "media": {
    object (MediaContext)
  },
  "canvas": {
    object (CanvasContext)
  }
}
Alanlar
media

object (MediaContext)

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

canvas

object (CanvasContext)

Geçerli tuvalle ilgili bağlam bilgilerini içerir.

MediaContext

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

JSON gösterimi
{
  "progress": string,
  "index": integer
}
Alanlar
progress

string (Duration format)

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

En fazla dokuz kesirli basamağa sahip, "s" ile sonlandırılmış, saniye cinsinden 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

Geçerli tuvalle ilgili bağlam bilgilerini içerir.

JSON gösterimi
{
  "state": value
}
Alanlar
state

value (Value format)

İsteğe bağlı. Durum, üçüncü taraf etkileşimli Tuval uygulaması tarafından belirlendi. Bu ayar yalnızca istek için belirlenir, yanıt için değildir. Örneğin, bu bir yemek tarifi uygulamasıysa durum struct : { "current_page" : 5, "son_sayfa" : 3, } Boyut sınırı 50 KB'tır.

Beklenen

Bir sonraki diyalog dönüşü için beklentileri açıklar.

JSON gösterimi
{
  "speech": [
    string
  ]
}
Alanlar
speech[]

string

İşlemin konuşmaya ağırlık verme için kullanıcının ifadesinden beklediği ifadelerin listesi. En fazla 1.000 ifadeye izin verilir. Not: Bu alan, v2 API'deki ExpectInput.speech_biasing_hints ile aynı anlama sahiptir.