Sohbet İşlemleri, 13 Haziran 2023'te kullanımdan kaldırılacak. Daha fazla bilgi için Görüşme İşlemleri'nin kullanımdan kaldırılması başlıklı makaleyi inceleyin.

Method: fulfill

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

fulfillment API'sini temsil eden TBG

HTTP isteği

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

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

İstek metni

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

JSON gösterimi
{
  "handler": {
    object (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ğıyla ilgili yerine getirilecek bilgiler. Örneğin, bilgi edinme amacı taşıyan bir isteğin "getFact" adında bir işleyicisi olabilir.

intent

object (Intent)

Zorunlu. Eşleşen son niyeti gösterir. https://developers.google.com/assistant/conversational/intents adresine göz atın.

scene

object (Scene)

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

session

object (Session)

Zorunlu. Oturum kimliği ve oturum parametreleri gibi oturum verilerini muhafazaya alır.

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 sayfasına göz atın.

device

object (Device)

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

context

object (Context)

İsteğe bağlı. Talebin güncel bağlamıyla ilgili bilgiler. Etkin medya oturumu veya tuval bilgileri dahil ancak bunlarla sınırlı değildir.

Yanıt metni

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

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

JSON gösterimi
{
  "prompt": {
    object (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ıkça daha önce eklenen iletilere eklenir.

scene

object (Scene)

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

session

object (Session)

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

user

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 sayfasına göz atın.

device

object (Device)

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

expected

object (Expected)

İsteğe bağlı. Sonraki diyalog dönüşüyle ilgili beklentileri açıklar.

İşleyici

Actions on Google'daki etkinlik bilgilerini sipariş karşılama ile eşleyen bir sipariş karşılama işleyicisini temsil eder. Sipariş karşılamada hangi kodu çalıştırmanız gerektiğini belirlemek için işleyici adını kullanın. Örneğin, "SiparişArama" gibi bir işleyici adıyla kullanıcının sipariş bilgilerine ulaşmak isteyen bir işleyici kullanılabilir. Diğeri ise "GetProductInfo" gibi bir işleyici adıyla bir veritabanından ürün bilgilerini alabilir.

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

string

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

Amaç

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

JSON gösterimi
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Alanlar
name

string

Zorunlu. Eşleşen son niyetin adı.

params

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

Zorunlu. Amaç eşleştirmenin bir parçası olarak tanımlanan parametreleri gösterir. Bu, tanımlanan parametre adının kullanıcı girişinden tanımlanan parametre değeriyle eşlenir. Tanımlanan eşleşen amaçta tanımlanan tüm parametreler burada gösterilir.

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

query

string

İsteğe bağlı. Son kullanıcıdan bu niyetle eşleşen yazılı veya sözlü giriş. Bu değer, kullanıcı girişine göre bir niyet eşleştiğinde doldurulur.

IntentParametre Değeri

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

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

string

Zorunlu. Kullanıcı açıklamasından alınan orijinal metin değeri.

resolved

value (Value format)

Zorunlu. Kullanıcı girişinden çıkarılan parametre için yapılandırılmış değer. Bu alan, yalnızca eşleşen parametrede parametre tanımlanmışsa ve parametrenin değeri amaç eşleşmesi sırasında tanımlanabilirse doldurulur.

Düzen

Bir sahneyi göstermek. Sahneler kullanıcı memnuniyetini arayabilir, istem ekleyebilir ve alan değerlerini toplayabilir. Sahneler, etkinlikler veya niyetler tarafından tetiklenir ve diğer sahnelere geçmek için etkinlikleri ve niyetleri tetikleyebilir.

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

string

Zorunlu. Geçerli sahnenin adı.

slotFillingStatus

enum (SlotFillingStatus)

Zorunlu. Slot doldurmanın mevcut durumu. Bu alan salt okunur durumdadır.

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 çift listesi içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

next

object (NextScene)

İsteğe bağlı. Sahnedeki bir sonraki adımda yürütülecek bilgiler.

SlotDolgu Durumu

Slot doldurmanın mevcut durumunu gösterir.

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

Alan

Bir alanı temsil eder.

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

enum (SlotMode)

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

status

enum (SlotStatus)

Yuvanın durumu.

value

value (Value format)

Alanın değeri. Yanıttaki bu değerin değiştirilmesi, alan doldurma alanındaki değeri değiştirir.

updated

boolean

Alan değerinin son dönüşte toplanıp toplanmadığını belirtir. Bu alan salt okunur durumdadır.

prompt

object (Prompt)

İsteğe bağlı. Bu istem, gerekli bir alanı doldurması gerektiğinde kullanıcıya gönderilir. Bu istem, konsolda tanımlanan mevcut istemi geçersiz kılar. Bu alan webhook isteğine dahil değildir.

SlotModu

Bir alanın modunu temsil eder. Yani zorunlu olup olmadığını gösterir.

Sıralamalar
MODE_UNSPECIFIED Kullanım alanı doldurulmadığında yedek değer.
OPTIONAL Slot doldurma işleminin tamamlanması için alanın gerekli olmadığını belirtir.
REQUIRED Slot doldurma işleminin tamamlanması için alanın gerekli olduğunu belirtir.

SlotDurumu

Bir yuvanın durumunu gösterir.

Sıralamalar
SLOT_UNSPECIFIED Kullanım alanı doldurulmadığında yedek değer.
EMPTY Alanda hiçbir değer olmadığını belirtir. Bu durum yanıtı kullanarak değiştirilemez.
INVALID Alan değerinin geçersiz olduğunu belirtir. Bu durum, yanıt üzerinden ayarlanabilir.
FILLED Alanda bir değer olduğunu belirtir. Bu durum yanıtı kullanarak değiştirilemez.

İstem

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

JSON gösterimi
{
  "override": boolean,
  "firstSimple": {
    object (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 nasıl birleştirileceği modu. "true", önceden tanımlanmış tüm iletileri (ilk ve sonuncu, içerik, öneriler bağlantısı ve tuval) temizler ve bu istemde tanımlanan mesajları ekler. "false", bu istemde tanımlanan mesajları önceki yanıtlarda tanımlanan iletilere ekler. Bu alanı "false" (yanlış) olarak bırakırsanız Basit istemler, Öneriler istemi ve Tuval istemi'ndeki (İçerik isteminin bir parçası) bazı alanlara ekleme yapabilirsiniz. İstemde tanımlanırsa içerik ve bağlantı mesajlarının üzerine her zaman yazılır. Varsayılan değer "false" (yanlış) değeridir.

firstSimple

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 içerik.

lastSimple

object (Simple)

İsteğe bağlı. Son ses ve yalnızca metin yanıtı.

suggestions[]

object (Suggestion)

İsteğe bağlı. Kullanıcıya gösterilecek öneriler, her zaman yanıtın sonunda görünür. Kapsayıcı istemindeki "geçersiz kıl" alanı "yanlış" ise bu alanda tanımlanan başlıklar, daha önce tanımlanan tüm öneri istemlerinde tanımlanan başlıklara eklenir ve yinelenen değerler kaldırılır.

canvas

object (Canvas)

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

orderUpdate

object (OrderUpdate)

İsteğe Bağlı İşlem, işlem akışı sırasında siparişi aldıktan sonra bir OrderUpdate ile yanıt verir. Google bunu aldıktan sonra, siparişe ilişkin bu güncellemeyi kaydeder ve başarılı olursa, görüntüleme cihazlarında gönderilen TTS ile birlikte bir makbuz kartı görüntüler.

Basit

Kullanıcıya gönderilmek üzere basit bir istemi gösterir. https://developers.google.com/assistant/conversational/prompts- Simple adresine göz atın.

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

string

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

text

string

Sohbet balonunda gösterilecek isteğe bağlı metin. Belirtilmezse, yukarıdaki konuşma alanının görüntü oluşturma işlemi kullanılır. 640 karakterle sınırlıdır. Kapsayıcı istemindeki "geçersiz kıl" alanı "doğru" ise bu alanda tanımlanan metin, önceki Basit istemin metniyle değiştirilir.

İçerik

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

JSON gösterimi
{

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

Birlik alanı content.

content aşağıdakilerden yalnızca biri olabilir:

card

object (Card)

Temel kart.

image

object (Image)

Resim.

table

object (Table)

Tablo kartı.

media

object (Media)

Oynatılacak medya grubunu gösteren yanıt.

collection

object (Collection)

Arasından seçim yapabileceğiniz bir dizi seçeneğin gösterildiği kart.

list

object (List)

Arasından seçim yapabileceğiniz bir seçenek listesi sunan kart.

collectionBrowse

object (CollectionBrowse)

Açılan web sayfaları koleksiyonunu gösteren kart.

Kart

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

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}
Alanlar
title

string

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

subtitle

string

İsteğe bağlı.

text

string

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

image

object (Image)

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

imageFill

enum (ImageFill)

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

button

object (Link)

Giden bağlantıya sahip düğme. İsteğe bağlı.

Resim

Kartta gösterilen bir resim. https://developers.google.com/assistant/conversational/prompts-rich#image-cards adresine göz atın.

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

string

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

alt

string

Erişilebilirlik için kullanılacak görselin 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ı.

Resim Dolgusu

Resmin sunumunu etkileyen olası resim görüntüleme seçenekleri. Bu, resmin en boy oranı resim kapsayıcısının en boy oranıyla eşleşmediğinde kullanılmalıdır.

Sıralamalar
UNSPECIFIED
GRAY Resim ve resim kapsayıcısı arasındaki boşlukları gri çubuklarla doldurun.
WHITE Resim ve resim kapsayıcısı arasındaki boşlukları beyaz çubuklarla doldurun.
CROPPED Resim, resim genişliği ve yüksekliği kapsayıcı kapsayıcı boyutlarıyla veya bu boyutların üzerinde olacak şekilde ölçeklendirilir. Bu durum, ölçeklenmiş resim yüksekliği kapsayıcı yüksekliğinden büyükse resmin üst ve alt kısmını kırpabilir veya ölçeklendirilmiş resim genişliği kapsayıcı genişliğinden büyükse resmin sol ve sağ taraflarını kırpabilir. Bu, 4:3 oranındaki bir videoyu oynatırken geniş ekran TV'de "Yakınlaştırma Moduna" benzer.

OpenUrl

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

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulama bağlantılı bir uygulamayı veya web sayfasını açmak için kullanılan http/https url'leri

hint

enum (UrlHint)

URL türü için bir ipucunu gösterir.

URLİpucu

Farklı türde URL ipuçları.

Sıralamalar
AMP Doğrudan AMP içeriğine veya aracılığıyla AMP içeriğine başvuruda bulunan standart bir URL'ye işaret eden URL. https://amp.dev/ adresine bakın.

Tablo

Bir metin tablosu görüntülemek için kullanılan tablo kartı. https://developers.google.com/assistant/conversational/prompts-rich#table_cards adresine göz atın.

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

string

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

subtitle

string

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

image

object (Image)

Tabloyla ilişkilendirilmiş resim. İsteğe bağlı.

columns[]

object (TableColumn)

Sütunların başlıkları ve hizalaması.

rows[]

object (TableRow)

Tablonun satır verileri. İlk 3 satırın gösterilmesi garanti edilir ancak diğerleri belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi satırların gösterileceğini görmek için lütfen simülatör ile test yapın. WEB_BROWSER özelliğini destekleyen yüzeylerde kullanıcıyı daha fazla veri içeren bir web sayfasına yönlendirebilirsiniz.

button

object (Link)

Düğme.

TabloSütun

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

string

Sütun için başlık metni.

align

enum (HorizontalAlignment)

w.r.t sütunundaki içeriğin yatay hizalaması. Belirtilmemesi halinde içerik ön kenara hizalanır.

Yatay Hizalama

Hücredeki içeriğin hizalaması.

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

TabloSatırı

Tablodaki bir satırı açıklar.

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

object (TableCell)

Bu satırdaki hücreler. İlk 3 hücrenin gösterileceği garanti edilir ancak bazı hücreler belirli yüzeylerde kesilebilir. Belirli bir yüzeyde hangi hücrelerin gösterileceğini görmek için lütfen simülatör ile test yapın.

divider

boolean

Her satırdan sonra bir ayırıcı olup olmadığını belirtir.

TabloHücresi

Bir satırdaki hücreyi tanımlar.

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

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 ofsetini başlat.

Saniyede en fazla dokuz ondalık basamak içeren ve "s" ile sonlanan 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 istek üçüncü taraf olarak yapılır. Ayarlanmazsa 3p, iki varsayılan kontrol türünü (FINISHED ve SUCCESS) işlemeye devam etmelidir.

mediaObjects[]

object (MediaObject)

Medya Nesnelerinin Listesi

repeatMode

enum (RepeatMode)

Medya Nesneleri listesi için tekrarlama modu.

firstMediaObjectIndex

integer

mediaObjects içindeki ilk Medya Nesnesinin oynatılacağı 0 tabanlı dizin. Belirtilmezse sıfır veya sınırların dışındaysa oynatma, mediaObjects içindeki ilk medya nesnesinde başlar.

MedyaTürü

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

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

İsteğe Bağlı Medya Denetimleri

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

Sıralamalar
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED Değer belirtilmemiş
PAUSED Duraklatılmış etkinlik. Kullanıcı medyayı duraklattığında tetiklenir.
STOPPED Etkinlik durduruldu. Kullanıcı, medya oynatma sırasında oturumun 3. oturumundan çıktığında tetiklenir.

MedyaNesnesi

Tek bir medya nesnesini temsil eder

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

string

Bu medya nesnesinin adı.

description

string

Bu medya nesnesinin açıklaması.

url

string

Medya içeriğini işaret eden URL. MP3 dosyaları bir web sunucusunda barındırılmalı ve HTTPS URL'si üzerinden herkese açık bir şekilde bulunmalıdır. Canlı yayın yalnızca MP3 biçiminde desteklenir.

image

object (MediaImage)

Medya kartıyla gösterilecek resim.

MedyaGörüntüsü

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

Birlik alanı image.

image aşağıdakilerden yalnızca biri olabilir:

large

object (Image)

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

icon

object (Image)

Başlıkta, sağ tarafta küçük bir resim simgesi gösteriliyor. 36x36 dp olarak yeniden boyutlandırılır.

Tekrar Modu

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

Sıralamalar
REPEAT_MODE_UNSPECIFIED KAPALI değerine karşılık gelir.
OFF Son medya nesnesinin sonundaki medya oturumunu sona erdirin.
ALL Son medya nesnesinin sonuna gelindiğinde ilk medya nesnesinin başlangıcına gidin.

Koleksiyon

Seçilebilecek seçenekleri içeren bir kart. https://developers.google.com/assistant/conversational/prompts-selection#collection adresine göz atın

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
Alanlar
title

string

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

subtitle

string

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

items[]

object (CollectionItem)

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

imageFill

enum (ImageFill)

Koleksiyon öğelerinin resim arka planları nasıl doldurulur? İsteğe bağlı.

KoleksiyonÖğesi

Koleksiyondaki bir öğe

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

string

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

Liste

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

JSON gösterimi
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}
Alanlar
title

string

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

subtitle

string

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

items[]

object (ListItem)

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

ListItem

Listedeki bir öğe

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

string

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

Koleksiyona Göz Atma

Bir grup web dokümanı, büyük parçalardan oluşan bir koleksiyon olarak sunar. Öğeler, ilişkili web dokümanlarının web görüntüleyicide başlatılması için seçilebilir. https://developers.google.com/assistant/conversational/prompts-selection#collectionbrowsing adresini ziyaret edin.

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

object (Item)

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

imageFill

enum (ImageFill)

Resim görüntüleme seçeneği 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 öğesinin altbilgi metni. Açıklamanın altında gösterilir. Üç satırlık metinle kesilmiş tek satır.

image

object (Image)

Koleksiyon öğesinin resmi.

openUriAction

object (OpenUrl)

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

Öneri

Öneriler, Asistan'ın istemi görüntülemesi durumunda, görüntüleme özellikli cihazlarda kullanıcılara öneri çipleri sağlar. Görüşmeye devam etmek veya özet oluşturmak için kullanıcı yanıtlarını belirtmek üzere öneri çiplerini kullanın. Dokunulduğunda, bir öneri çipi gösterilen metni görüşme sırasında olduğu gibi kullanıcı tarafından yazılmış gibi döndürür. https://developers.google.com/assistant/conversational/prompts#suggestions adresini inceleyin

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

string

Zorunlu. Öneri çipinde gösterilen metin. Bu mesaja dokunulduğunda, kullanıcı yazmış gibi sohbet mesajında tekrar yayınlanır. Her başlık, öneri çipleri grubu arasında benzersiz olmalıdır. Maks. 25 karakter

Tuval

Kullanıcıya gönderilecek Etkileşimli Tuval yanıtını temsil eder. Bu, etkileşimli bir tuval yanıtını görüntülemenin yanı sıra kapsayıcıda kullanıcı ile konuşma komutu içeren "firstBasit" alanıyla birlikte kullanılabilir. Maksimum yanıt boyutu 50.000 bayttır. https://developers.google.com/assistant/interactivecanvas adresine göz atın.

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

string

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

data[]

value (Value format)

İsteğe bağlı. Etkinlik olarak etkileyici deneyim web sayfasına aktarılacak JSON verileri. Kapsamdaki istemdeki "geçersiz kıl" alanı "yanlış" ise bu Tuval isteminde tanımlanan veri değerleri, önceki Tuval istemlerinde tanımlanan veri değerlerinden sonra eklenir.

suppressMic

boolean

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

continuousMatchConfig

object (ContinuousMatchConfig)

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

SürekliEşleşme Yapılandırması

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

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

object (ExpectedPhrase)

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

durationSeconds

integer

Sürekli eşleşme modunu açık tutma süresi. Belirtilirse süre dolduğunda mikrofon kapatılır. İzin verilen maksimum değer 180'dir.

Beklenen İfade

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

string

Sürekli eşleşme modu oturumu sırasında eşleştirilecek ifade.

alternativePhrases[]

string

Konuşma ön yargısı olsa bile bazı ifadeler konuşma modeli tarafından yanlış tanınabilir. Bu, geliştiricilerin eşofmanlar için alternatif tetikleyiciler belirtmesine olanak tanır.

Sipariş Güncellemesi

Bir siparişe güncelleyin.

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

enum (Type)

Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_maskeyi kullanın. SNAPSHOT yazarsanız, OrderUpdate.order tüm sipariş olmalıdır. = ORDER_STATUS değeri, sipariş seviyesinde durum değişikliğidir. Yalnızca sipariş.last_update_time ve bu dikey durum bilgisi alınır. Not: type.ORDER_STATUS, yalnızca PurcahaseOrderExtension durum güncellemelerini destekler ve bu desteğin kapsamını genişletmeyle ilgili bir plan yoktur. Bunun yerine, daha genel, genişletilebilir ve tüm sektörler için kullanılabildiğinden updateMask'i kullanmanızı öneririz.

order

object (Order)

updateMask

string (FieldMask format)

Not: Aşağıdaki özel alanlar için dikkate alınması gereken bazı noktalar vardır: 1. sipariş isteği.last_update_time, güncelleme isteğinin bir parçası olarak her zaman güncellenecektir. 2. updateMask'ın bir parçası olarak sağlanırsa Order.create_time, Order.google_order_id ve Order.merchant_order_id yok sayılır.

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

userNotification

object (UserNotification)

Belirtilirse kullanıcıya belirtilen başlığı ve metni içeren bir bildirim gösterir. Bildirim belirtmek, bildirim gönderilmesi için bir öneridir ve sonuç olarak bildirim alacağı garanti edilmez.

reason

string

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

Tür

Kullanımdan kaldırıldı: Bunun yerine OrderUpdate.update_maskeyi kullanın. Sipariş için izin verilen güncellemeler.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi. Bu değer açık bir şekilde ayarlanmamalıdır.
ORDER_STATUS Yalnızca siparişin durumu güncellenir.
SNAPSHOT Sipariş anlık görüntüsünü güncelleyin.

Sırala

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

JSON gösterimi
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

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

string

Google tarafından atanan sipariş kimliği.

merchantOrderId

string

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

userVisibleOrderId

string

Mevcut siparişe referans veren kullanıcı kimliği. Bu kimlik; web siteleri, uygulamalar ve e-posta dahil olmak üzere diğer bağlamlarda bu sipariş için gösterilen kimlikle tutarlı olmalıdır.

userVisibleStateLabel
(deprecated)

string

Kullanımdan kaldırıldı: Bunun yerine OrderExtension durumunu kullanın. Bu siparişin durumu için kullanıcı tarafından görülebilen etiket.

buyerInfo

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.

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Siparişin son güncellendiği tarih ve saat. OrderUpdate için gerekli.

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "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 ana sayfasındaki satır öğesiyle Expedia siparişi.

contents

object (Contents)

Gerekli: Satır öğeleri grubu olan sipariş içeriği.

priceAttributes[]

object (PriceAttribute)

Fiyat, indirimler, vergiler ve benzer bilgiler.

followUpActions[]

object (Action)

Sipariş düzeyindeki takip işlemleri.

paymentData

object (PaymentData)

Siparişle ilgili ödemeyle ilgili veriler.

termsOfServiceUrl

string

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

note

string

Siparişe eklenen notlar.

promotions[]

object (Promotion)

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

disclosures[]

object (Disclosure)

Bu siparişle ilişkili açıklamalar.

vertical
(deprecated)

object

Kullanımdan kaldırıldı: Bunun yerine temaları kullanın. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu sektör, satır öğesi düzeyindeki sektör türüyle eşleşmelidir. Olası değerler: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

Birlik alanı verticals. Bu özellikler, bazı satır öğelerinde geçersiz kılınmadığı sürece tüm satır öğeleri için geçerli olur. Bu sektör, satır öğesi düzeyindeki sektör türüyle eşleşmelidir. verticals aşağıdakilerden yalnızca biri olabilir:
purchase

object (PurchaseOrderExtension)

Satın alma siparişi

ticket

object (TicketOrderExtension)

Bilet siparişi

UserInfo

Kullanıcı hakkında bilgi. Bir siparişle ilişkili kullanıcının bilgilerini göstermek için kullanılır.

JSON gösterimi
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Alanlar
email

string

Kullanıcı e-posta adresi, ör. burcinbilgili@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ı, addan veya soyadından farklı olabilir.

phoneNumbers[]

object (PhoneNumber)

Kullanıcının telefon numaraları.

PhoneNumber

Standart telefon numarası temsili.

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

string

Uluslararası Telekomünikasyon Birliği (ITU) Öneri E.164'te tanımlandığı gibi, E.164 biçiminde telefon numarası. https://en.wikipedia.org/wiki/E.164

extension

string

Dahili numara, en fazla 40 haneden oluşan bir dizi sayı olarak tanımlanma dışında ITU önerilerinde standartlaştırılmamıştır. Uzantıda baştaki sıfırın kullanılabilmesi için buradaki dize olarak tanımlanır (standart tanımlı olmadığından kuruluşların bunu yapmak için tam özgürlüğü vardır). Rakamlar dışında, "," (beklemeyi belirtir) gibi diğer arama karakterleri de burada bulunabilir. Örneğin, xxx-xxx-xxxx dahili 123 uzantısında "123" uzantısıdır.

preferredDomesticCarrierCode

string

Bu telefon numarasını yurtiçi ararken tercih edilen operatör seçim kodu. Ayrıca, bazı ülkelerde sabit hatlardan cep telefonlarına arama yaparken bazı ülkelerdeki numaraların çevrilmesi gerekir. Örneğin, Kolombiya'da bir cep telefonundan yurt içi sabit telefona arama yaparken numaradan önce "3" aranmalıdır (diğer şekilde)

Bunun "tercih edilen" kod olduğunu, diğer kodların da kullanılabileceğini unutmayın.

Resim

Kartta gösterilen bir resim.

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

string

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

accessibilityText

string

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

height

integer

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

width

integer

Resmin piksel cinsinden genişliği. İsteğe bağlı.

Satıcı

Alışveriş sepeti/sipariş/satır öğesi için satıcı.

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

image

object (Image)

Satıcıyla ilişkili resimdir.

phoneNumbers[]

object (PhoneNumber)

Satıcının telefon numaraları.

address

object (Location)

Satıcının adresi.

Konum

Bir konumu temsil eden kapsayıcı.

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

object (LatLng)

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

formattedAddress

string

Görünen adres, ör. "1600 Amphitheatre Pkwy, Mountain View, CA 94043". [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] iznini gerektirir.

zipCode

string

Posta kodu. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir.

city

string

Şehir. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir.

postalAddress

object (PostalAddress)

Posta adresi. [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] veya [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION] iznini gerektirir.

name

string

Yerin adı.

phoneNumber

string

Konumun telefon numarası. Örneğin, işletmenin bulunduğu konumun iletişim numarası veya teslimat konumunun telefon numarası.

notes

string

Konumla ilgili notlar.

placeId

string

Yer kimliği, bir yerin ayrıntılarını getirmek için Yerler API'si ile kullanılır. https://developers.google.com/places/web-service/place-id adresine bakın.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, derece enlemini ve dereceyi boylamı temsil etmek için çift olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklarda olmalıdır.

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

number

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

longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

PostalAddress

Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Posta adresi göz önüne alındığında bir posta hizmeti öğeleri bir tesise, posta kutusuna veya benzer bir yere teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Genelde adres, işlemin türüne bağlı olarak kullanıcı girişi yoluyla veya mevcut verileri içe aktararak oluşturulur.

Adres girişi / düzenlemesi hakkında tavsiye: - https://github.com/google/libaddressinput gibi i18n için hazır bir adres widget'ı kullanın) - Kullanıcılara, bu alanın kullanıldığı ülkelerin dışındaki alanların girişi veya düzenlemesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için lütfen şu adresi ziyaret edin: https://support.google.com/business/answer/6397478

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

integer

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

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

regionCode

string

Zorunlu. Adresteki ülkenin/bölgenin CLDR bölge kodu. Bu çıkarım hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılı bilgi için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/Charts/30/supplemental/region_information.html adresine göz atın. Örnek: İsviçre için "CH".

languageCode

string

İsteğe bağlı. Bu adrese ait içeriklerin BCP-47 dil kodu (biliniyorsa). Bu, genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin ülkesinde/bölgesinde kullanılan dillerden biriyle ya da harf çevirisindeki eşdeğerleriyle eşleşmesi beklenir. Bu durum, bazı ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve biçimlendirmeyi veya biçimlendirmeyle ilgili olmayan diğer işlemleri hiçbir zaman etkilemez.

Bu değer bilinmiyorsa unutulmalıdır (yanlış olabilecek bir varsayılan belirtmek yerine).

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

postalCode

string

İsteğe bağlı. Adresin posta kodu. Tüm ülkeler posta kodlarının var olmasını zorunlu tutmaz. Ancak bu kodların kullanıldığı yerlerde adresin diğer bölümleriyle birlikte ek doğrulamalar (ör. ABD'de eyalet/posta doğrulaması) tetikleyebilir.

sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Çoğu bölgede kullanılmaz. Değer kullanıldığında değer, "CEDEX" gibi bir dize, bunu takip eden bir sayı (ör. "CEDEX 7") veya yalnızca bir sayıdır ve "sektör kodu" (Jamaika), "teslimat bölgesi göstergesi" (Malawi) veya "postane göstergesi"ni (ör. Fildişi Sahili) temsil eder.

administrativeArea

string

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

locality

string

İsteğe bağlı. Genellikle adresin şehir/şehir bölümünü belirtir. Örnekler: ABD şehri, BT komitesi, Birleşik Krallık posta şehri. Şehirlerin iyi tanımlanmadığı veya bu yapıya iyi sığmadığı bölgelerde, semti boş bırakın ve addressLines kullanın.

sublocality

string

İsteğe bağlı. Adresin alt semti. Örneğin bu; mahalleler, ilçeler, mahalleler olabilir.

addressLines[]

string

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

addressLines alanındaki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla değer (ör. "Austin, TX") içerebileceğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bu özelliğin değişebileceği yerlerde (ör. Japonya), adresi göstermek için address_language [ör. büyük veya küçük siparişlerde "ja", küçükten büyüğe "ja-Latn" veya "en") kullanılır. Bu şekilde, adrese göre en spesifik satır dili dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, adres satırlarında kalan tüm bilgilerin bulunduğu bir regionCode'dan oluşur. Böyle bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olsa da, en azından kısmen çözülmeden adres bileşenlerinin hiçbiriyle ilgili anlamsal gerekçeler sağlanamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturmak, ardından yapılandırılmamış adreslerin işlenmesi için önerilen adres coğrafi kodlamadır (adresin hangi bölümlerinin semt veya bağlı bölge olması gerektiğini tahmin etmek yerine).

recipients[]

string

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

organization

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 zorunludur ve en fazla 50 satıra izin verilir. Tüm satır öğeleri aynı sektöre ait olmalıdır.

Satır Öğesi

Bir satır öğesi bir sektör içeriyor. Bir sipariş veya alışveriş sepetinde aynı sektörde birden fazla satır öğesi bulunabilir. Alt satır öğeleri/eklentiler, kullanım alanlarına göre dikey protolarda tanımlanmalıdır. Not: 1. Aksi belirtilmedikçe tüm seviyelerdeki tüm dizeler 1.000 karakterden az olmalıdır. 2. Aksi belirtilmedikçe, tüm düzeylerde tekrarlanan tüm alanlar 50'den az olmalıdır. 3. Belirtilmişse, tüm düzeylerdeki tüm zaman damgaları geçerli zaman damgaları olmalıdır.

JSON gösterimi
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (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 PurchaseOrderExtension.status özelliğini 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ı ANA ile Expedia siparişi.

priceAttributes[]

object (PriceAttribute)

Satır öğesi düzeyinde fiyat ve ayarlamalar.

followUpActions[]

object (Action)

Satır öğesinde takip işlemleri.

recipients[]

object (UserInfo)

Satır öğesi düzeyindeki müşteriler (bu, Sipariş düzeyindeki alıcıdan farklı olabilir). Örnek: X kullanıcısı Y kullanıcısı adına restoran rezervasyonu yaptı.

image

object (Image)

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

description

string

Satır öğesi açıklaması.

notes[]

string

Belirli bir 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

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

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

Birlik alanı verticals. Gerekli: Satır öğesinin türüne/sektörüne göre Semantik İçeriği. Her tema kendi sipariş karşılama ayrıntılarını içermelidir. verticals aşağıdakilerden yalnızca biri olabilir:
purchase

object (PurchaseItemExtension)

Ürün, gıda vb. satın alma işlemleri.

reservation

object (ReservationItemExtension)

Restoran, saç kesimi vb. rezervasyon siparişleri

PriceAttribute (Fiyat Özelliği)

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

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

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

enum (Type)

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

name

string

Gerekli: Fiyat özelliğinin kullanıcı tarafından görüntülenen dizesi. Bu bilgiler satıcı tarafından gönderilir ve yerelleştirilir.

id

string

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

state

enum (State)

Zorunlu: Fiyatın durumu: Tahmini ve Gerçek fiyat karşılaştırması.

taxIncluded

boolean

Fiyatın vergi dahil olup olmadığı.

Birlik alanı spec. Para tutarını veya milisaniye yüzdesini gösterir. spec aşağıdakilerden yalnızca biri olabilir:
amount

object (Money)

Para tutarı.

amountMillipercentage
(deprecated)

integer

Yüzde spesifikasyonunun yüzde 1/1000'ine oranı. Örneğin, %8,750 %8750 olarak, negatif yüzdeler ise yüzdelik indirimleri ifade eder. Bu alan kullanımdan kaldırılıyor. Katı kullanım alanı gerekli olduğunda tekrar ekleyebilirsiniz.

Tür

Para türünü gösterir.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmedi. İstemciler bunu açıkça belirtmek zorunda kalmamalıdır.
REGULAR İndirimler uygulanmadan önceki normal görüntüleme fiyatı.
DISCOUNT Alt toplamdan çıkarılacak.
TAX Alt toplama eklenecek.
DELIVERY Alt toplama eklenecek.
SUBTOTAL Bazı ücretler eklenmeden önceki alt toplam.
FEE Ek Ücret.
GRATUITY Alt toplama eklenecek.
TOTAL Siparişin veya satır öğesinin fiyatı gösteriliyor.

Eyalet

Fiyat durumunu gösterir.

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

Money

Para birimi türüyle para tutarını temsil eder.

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

string

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

amountInMicros

string (int64 format)

Mikro cinsinden miktar. Örneğin, bu alan 1,99 TL olarak 1990000 olarak ayarlanmalıdır.

İşlem

Sipariş veya satır öğesiyle ilişkili bir takip işlemi.

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

enum (Type)

Gerekli: İşlem türü.

title

string

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

openUrlAction

object (OpenUrlAction)

Yapılması gerekenler.

actionMetadata

object (ActionMetadata)

Bir işlemle ilişkilendirilen meta veriler.

Tür

Olası takip işlemleri.

Sıralamalar
TYPE_UNSPECIFIED Belirtilmemiş işlem.
VIEW_DETAILS Sipariş ayrıntıları işlemini görüntüleyin.
MODIFY Sipariş işlemini değiştirin.
CANCEL Sipariş işlemini iptal edin.
RETURN İade sırası işlemi.
EXCHANGE Exchange sipariş işlemi.
EMAIL

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

CALL

Telefon araması işlemi.

REORDER İşlemi yeniden sırala.
REVIEW Sipariş işlemini inceleyin.
CUSTOMER_SERVICE Müşteri hizmetleriyle iletişime geçin.
FIX_ISSUE Sorunu gidermek için satıcı sitesine veya uygulamasına gidin.
DIRECTION Yol tarifi bağlantısı.

OpenUrlİşlemi

Belirtilen URL'yi açar.

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

string

Şunlardan herhangi biri olabilecek URL alanı: - Uygulama bağlantılı bir uygulamayı veya web sayfasını açmak için kullanılan http/https url'leri

androidApp

object (AndroidApp)

URL'nin bir Android uygulaması tarafından doldurulmasının beklendiği durumlarda Android uygulamasıyla ilgili bilgiler.

urlTypeHint

enum (UrlTypeHint)

URL türü için bir ipucunu gösterir.

Android Uygulaması

Sipariş karşılama kısıtlamaları için Android uygulamasının spesifikasyonu

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

string

Paket adı, Android yerine getirme belirtilirken paket adı belirtilmelidir.

versions[]

object (VersionFilter)

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

SürümFiltresi

Uygulamanın belirli sürümleri gerekliyse EditionFiltre dahil edilmelidir.

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

integer

Min. sürüm kodu veya 0 (dahil).

maxVersion

integer

Maksimum sürüm kodu (dahil). Değer, [minVersion:maxVersion] şeklindedir. Boş aralık, tüm sürümleri ifade eder. Örnekler: Tek bir sürüm belirtmek için şunu kullanın: [target_version:target_version]. Herhangi bir sürümü belirtmek için minVersion ve maxVersion değerini belirtmeden bırakın. maxVersion sürümüne kadar tüm sürümleri belirtmek için minVersion değerini belirtmeden bırakın. minVersion'daki tüm sürümleri belirtmek için maxVersion'ı belirtilmemiş olarak bırakın.

URLTürİpucu

Farklı türde URL ipuçları.

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

İşlemMeta verisi

İşlem başına ilgili meta veri.

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

string (Timestamp format)

Bu işlemin sona ereceği zaman.

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Açıklama

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

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

string

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

disclosureText

object (DisclosureText)

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

presentationOptions

object (DisclosurePresentationOptions)

Açıklamanın sunu seçenekleri.

AçıklamaMetni

Web bağlantılarını içeren bir düz metni temsil eder.

JSON gösterimi
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Alanlar
template

string

Eklenmesi gereken her bir metin bağlantısı için "{0}" ve "{1}" gibi yer tutucuları içeren, gösterilecek metin. Örnek: "UYARI: Bu ürün sizi, Kaliforniya Eyaleti'nin kansere neden olduğu bilinen kimyasallara maruz bırakabilir. Daha fazla bilgi için {0} adresine gidin." Bu açıklama metni, tanıtım veya reklam benzeri içerik barındırmamalıdır.

AçıklamaSunum Seçenekleri

Açıklamanın sunulmasına ilişkin seçenekler.

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

enum (PresentationRequirement)

Açıklamanın sunuluş şartı.

initiallyExpanded

boolean

Açıklama içeriğinin başlangıçta genişletilip genişletilmeyeceğini belirtir. Varsayılan olarak, başlangıçta daraltılmış durumdadır.

Sunu Gereksinimi

Açıklamanın sunulmasıyla ilgili koşul.

Sıralamalar
REQUIREMENT_UNSPECIFIED Belirtilmemiş koşul. Bu ayar açık bir şekilde ayarlanmamalıdır.
REQUIREMENT_OPTIONAL Açıklama isteğe bağlıdır. Cihaz, açıklamaların gösterilmesini desteklemiyorsa bu mesaj atlanabilir.
REQUIREMENT_REQUIRED Açıklama gerekli. Cihaz, açıklamaların gösterilmesini desteklemiyorsa telefon üzerinden görüşme yapılır.

Satın AlmaÖğe Uzantısı

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

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

Zorunlu: 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)

Gerekli: Satın alma türü.

productId
(deprecated)

string

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

quantity

integer

Öğenin miktarı.

unitMeasure

object (MerchantUnitMeasure)

Birim ölçümü. Öğenin seçilen birimlerdeki boyutunu belirtir. Birim fiyatı belirlemek için etkin fiyatla birlikte boyut kullanılır.

returnsInfo

object (PurchaseReturnsInfo)

Bu satır öğesinin bilgilerini döndürür. Ayarlanmazsa bu satır öğesi, sipariş seviyesinde iade bilgilerini devralır.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Bu satır öğesi için sipariş karşılama bilgileri. Politika ayarlanmadan bırakılırsa bu satır öğesi, sipariş düzeyindeki sipariş karşılama bilgilerini devralır.

itemOptions[]

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 yapılan fazladan alanlar. Not: Bu uzantının kullanılması kesinlikle önerilmez. Kullanım alanına/durumlara bağlı olarak aşağıdakilerden birini değerlendirin: 1. Diğer kullanım alanlarında (ör. genel yetenek/işlev) kullanılabiliyorsa PurchaseItemExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension kullanın.

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

Satın Alma Durumu

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

Sıralamalar
PURCHASE_STATUS_UNSPECIFIED Durum belirtilmedi.
READY_FOR_PICKUP Teslim alınmaya hazır.
SHIPPED Gönderildi.
DELIVERED Teslim edildi.
OUT_OF_STOCK Stokta yok.
IN_PREPARATION "IN_PREPARATION", farklı bağlamda farklı anlamlara gelebilir. YİYECEK sipariş yemek için hazırlanıyor olabilir. Perakende için bir öğenin paketlenmesi olabilir.
CREATED Sipariş oluşturuldu.
CONFIRMED Satıcı siparişi onayladı.
REJECTED Satıcı, siparişi veya satır öğesini reddetti.
RETURNED Öğe kullanıcı tarafından iade edildi.
CANCELLED Sipariş veya satır öğesi kullanıcı tarafından iptal edildi.
CHANGE_REQUESTED Kullanıcı siparişte değişiklik isteğinde bulundu ve entegratör bu değişikliği işliyor. Sipariş, istek işlendikten sonra başka bir duruma taşınmalıdır.

Satın Alma Türü

Satın alma kategorisi.

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

MerchantUnitmeasure

Satıcı birimi fiyatlandırma ölçüsü.

JSON gösterimi
{
  "measure": number,
  "unit": enum (Unit)
}
Alanlar
measure

number

Değer: 1.2 örneği.

unit

enum (Unit)

Birim: Örnek POUND, GRAM.

Birim

Sıralamalar
UNIT_UNSPECIFIED Birim belirtilmedi.
MILLIGRAM Miligram.
GRAM Gram
KILOGRAM Kilogram.
OUNCE Aa.
POUND Kare işareti

Satın Alma İadeleri Bilgisi

Bir siparişle veya belirli bir satır öğesiyle ilişkili bilgileri döndürür.

JSON gösterimi
{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}
Alanlar
isReturnable

boolean

Doğruysa dönüşe izin verilir.

daysToReturn

integer

İade işlemlerini bu kadar gün içinde yapabilirsiniz.

policyUrl

string

İade politikasına bağlantı.

Satın Alma Siparişi Bilgileri

Bir satın alma siparişi veya belirli bir satır öğesiyle ilişkili sipariş karşılama bilgileri.

JSON gösterimi
{
  "id": string,
  "fulfillmentType": enum (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ği için benzersiz tanımlayıcı.

fulfillmentType

enum (Type)

Gerekli: Sipariş karşılama türü.

expectedFulfillmentTime

object (Time)

Zaman aralığı belirtilmişse pencere, tek saat belirtilmişse GMR. Beklenen teslimat veya teslim alma süresi.

expectedPreparationTime

object (Time)

Zaman aralığı belirtilmişse pencere, tek saat belirtilmişse GMR. Yemeği hazırlamak 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 geçerlilik süresi.

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "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ş için 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ıdır ve storeCode, sipariş karşılama işleminin gerçekleştirildiği Walmart mağazasıdır. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Siparişin nasıl seçileceğiyle ilgili ek bilgiler. Bu alan yalnızca sipariş karşılama türü PICKUP olduğunda geçerli olur.

Tür

Sipariş karşılama türü.

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

Zaman

Kullanıcıya bir siparişi gösterirken kullanılacak etkinlik zamanını temsil eden zaman yapısı.

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

string

Rezervasyon zamanı, teslimat süresi gibi bir sipariş etkinliği zamanını temsil eder. Süre (başlangıç ve bitiş zamanı), yalnızca tarih, tarih saati vb. olabilir. Desteklenen tüm biçimler için https://en.wikipedia.org/wiki/ISO_8601 adresine bakın.

Teslim Alma Bilgisi

Bir siparişin nasıl alındığıyla ilgili ayrıntılar. Bu sayfada teslim alma türü ve varsa her türün ek meta verileri gibi ayrıntılar yer alır.

JSON gösterimi
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Alanlar
pickupType

enum (PickupType)

Teslim alma yöntemi (ör. MAĞAZA, CURBSIDE vb.)

curbsideInfo

object (CurbsideInfo)

Arabayla teslim alma bilgilerine özgü ayrıntılar. pickupType "CURBSIDE" değilse bu alan yok sayılır.

checkInInfo[]

object (CheckInInfo)

Girişi desteklemek için iş ortağı tarafından desteklenen çeşitli yöntemlerin listesi.

Teslim Alma Türü

Desteklenen teslim alma türlerinin listesi.

Sıralamalar
UNSPECIFIED Teslim alma türü belirtilmedi.
INSTORE Restoranın içinden yiyecek alın.
CURBSIDE Aracı, restoranın dışında yer alan belirli bir alana park eden bir kişi, orada yemek teslimatı yapar.

Araba Yolu Bilgisi

Arabaya teslim almanın nasıl kolaylaştırılacağıyla ilgili ayrıntılar.

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

enum (CurbsideFulfillmentType)

İş ortakları, arabaya teslim alma siparişlerini kolaylaştırmak için ek bilgilere ihtiyaç duyar. Hangi sipariş karşılama türünün seçildiğine bağlı olarak kullanıcıdan ilgili bilgiler toplanır.

userVehicle

object (Vehicle)

Siparişi veren kullanıcının araç ayrıntıları.

Arabaya Teslim AlmaTürü

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

Sıralamalar
UNSPECIFIED Arabaya teslim alma türü belirtilmemiş.
VEHICLE_DETAIL Arabaya teslim almayı kolaylaştırmak için araç ayrıntıları gerekiyor.

Araç

Bir araçla ilgili ayrıntılar

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

string

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

model

string

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

licensePlate

string

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

colorName

string

Araç renk 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. Bir jpg veya png olmalıdır. İsteğe bağlı.

GirişBilgileri

İş ortağının bir giriş yöntemini desteklemesi için gereken meta veriler.

JSON gösterimi
{
  "checkInType": enum (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 Check-in bilgileri e-postayla gönderilir.
SMS Giriş bilgileri SMS ile gönderilir.

ÖğeSeçeneği

Eklentileri veya alt öğeleri temsil eder.

JSON gösterimi
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Alanlar
id

string

Öğe seçeneği olarak benzersiz öğe kimliğini girin.

name

string

Seçenek adı.

prices[]

object (PriceAttribute)

Seçenek toplam fiyatı.

note

string

Seçenekle ilgili not.

quantity

integer

Öğe seçeneği olan 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.

Ürün Ayrıntıları

Ürünle ilgili ayrıntılar.

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

string

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

gtin

string

Ürünün Global Ticari Öğe Numarasıdır. Teklif kimliği Merchant Center'da yoksa yararlıdır. İsteğe bağlı.

plu

string

Çoğunlukla PLU kodları, PLU numaraları, PLU'lar, ürün kodları veya gıda etiketleri olarak adlandırılan fiyat arama kodları, marketler ve süpermarketlerde satılan toplu mahsulleri benzersiz şekilde tanımlayan bir numara sistemidir.

productType

string

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

productAttributes

map (key: string, value: string)

Ürünle ilgili satıcı tarafından sağlanan ayrıntılar, ör. { "allergen": "fıstık" }. Merchant Center'da teklif kimliği yoksa yararlıdır. İsteğe bağlı.

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

RezervasyonÖğeUzantısı

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

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

enum (ReservationStatus)

Zorunlu: Rezervasyon durumu.

userVisibleStatusLabel

string

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

type

enum (ReservationType)

Rezervasyon türü. Tür seçeneklerinden hiçbiri geçerli değilse ayarlanmış olmayabilir.

reservationTime

object (Time)

Hizmetin/etkinliğin gerçekleşmesi planlanan zaman. Bir tarih aralığı, tarih veya tam tarih olabilir.

userAcceptableTimeRange

object (Time)

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

confirmationCode

string

Bu rezervasyonun onay kodu.

partySize

integer

Kullanıcı sayısı.

staffFacilitators[]

object (StaffFacilitator)

Rezervasyona yardımcı olacak personel yardımcıları. Ör. Kuaför.

location

object (Location)

Hizmetin/etkinliğin konumu.

Rezervasyon Durumu

Rezervasyon durumu.

Sıralamalar
RESERVATION_STATUS_UNSPECIFIED Belirtilmemiş durum.
PENDING Rezervasyon beklemede.
CONFIRMED Rezervasyon onaylandı.
CANCELLED Rezervasyon kullanıcı tarafından iptal edildi.
FULFILLED Rezervasyon gerçekleşiyor.
CHANGE_REQUESTED Rezervasyon değişikliği istendi
REJECTED Rezervasyonun süresi doldu veya entegrasyon iş ortağı tarafından reddedildi.

Rezervasyon Türü

Rezervasyon türü.

Sıralamalar
RESERVATION_TYPE_UNSPECIFIED Belirtilmemiş tür.
RESTAURANT Restoran rezervasyonu.
HAIRDRESSER Kuaför rezervasyonu.

Personel-Eğitimci

Hizmet sorumlusuyla ilgili bilgiler.

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

string

Personelin eğitmeni adı. Ör. "Cem Demir"

image

object (Image)

Sanatçının resimleri.

Ödeme Verileri

Bir siparişle ilgili ödeme verileri.

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

object (PaymentResult)

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu. Ödeme deneyimi Actions on Google'da yönetiliyorsa bu alan, Actions on Google tarafından doldurulur.

paymentInfo

object (PaymentInfo)

Kullanıcının etkileşime girdiği sayfayla ilgili ödeme bilgileri.

ÖdemeSonuçu

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.

JSON gösterimi
{

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

string

Google, ödeme yöntemi verilerini sağladı. Ödeme işleyiciniz Google tarafından desteklenen ödeme işleyici olarak burada listeleniyorsa: https://developers.google.com/pay/api/ Daha fazla bilgi için bağlantıyı tıklayarak ödeme işleyicinize gidin. Aksi takdirde, yük ayrıntıları için aşağıdaki belgelere göz atın. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

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

Ödeme Bilgileri

Yapılan siparişle ilgili ödeme bilgileri. Bu proto, kullanıcıya yönelik etkileşim için faydalı olan bilgileri yakalar.

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

object (PaymentMethodDisplayInfo)

İşlem için kullanılan ödeme yönteminin görünen bilgileri.

paymentMethodProvenance

enum (PaymentMethodProvenance)

İşlem için kullanılan ödeme yönteminin kanıtı Kullanıcı hem google hem de satıcıda aynı ödeme yöntemini kaydetmiş olabilir.

Ödeme YöntemiGörüntüleme Bilgileri

Entegratör tarafından bir işlemi tamamlamak için kullanılan ödeme sonucu.

JSON gösterimi
{
  "paymentType": enum (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 **** 5678 numaralı hesabı kontrol etme

paymentMethodVoiceName

string

Yalnızca ses kullanan Asistan cihazları için kullanıcıya seslenecek ödeme yöntemi adı. Örneğin, "Bir iki iki elli dört ile biten vize" veya "beş altı sekiz sekizle biten vadesiz hesap". Not: Bu, yalnızca ses özellikli Asistan cihazlar için paymentMethodDisplayName yerine kullanılacak olan, ses için optimize edilmiş dizedir. Bu dize ayarlanmazsa bunun yerine paymentMethodDisplayName kullanıcıya okunur.

Ödeme Türü

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

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

Ödeme YöntemiProvenance

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

Sıralamalar
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Kaynak belirtilmedi.
PAYMENT_METHOD_PROVENANCE_GOOGLE Kaynak Google'dır.
PAYMENT_METHOD_PROVENANCE_MERCHANT Kaynağın kaynağı Satıcı'dır.

Tanıtım

Alışveriş sepetine eklenen promosyonlar/teklifler.

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

string

Gerekli: Bu teklife kupon kodu uygulandı.

Satın Alma Siparişi Uzantısı

Sektör/tema için sipariş uzantısı. Bu özellikler, bir satır öğesinde geçersiz kılınmadığı sürece sipariş içindeki tüm satır öğeleri için geçerlidir.

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

userVisibleStatusLabel

string

Durum için kullanıcıya görünen etiket/dize. İzin verilen maksimum uzunluk 50 karakterdir.

type

enum (PurchaseType)

Gerekli: Satın alma türü.

returnsInfo

object (PurchaseReturnsInfo)

Siparişle ilgili iade bilgileri.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Siparişle ilgili sipariş karşılama bilgileri.

purchaseLocationType

enum (PurchaseLocationType)

Satın alma işleminin yapıldığı yer (mağazada / çevrimiçi)

errors[]

object (PurchaseError)

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

extension
(deprecated)

object

Satıcı ile Google arasında yapılan fazladan alanlar. Not: Bu uzantının kullanılması kesinlikle önerilmez. Kullanım alanına/durumlara bağlı olarak aşağıdakilerden birini değerlendirin: 1. Diğer kullanım alanları için (ör. genel yetenek/işlev) kullanılabiliyorsa PurchaseOrderExtension'da alanları tanımlayın. 2. Özel, genel olmayan bir kullanım alanına/özelliğe özgüyse vertical_extension kullanın.

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

Satın Alma Konum Türü

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

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

Satın Alma Hatası

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

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

enum (ErrorType)

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

description

string

Hatayla ilgili ek açıklama.

entityId

string

Hataya karşılık gelen Varlık Kimliği. Buna örnek olarak LineItemId / ItemOptionId verilebilir.

updatedPrice

object (PriceAttribute)

PRICE_CHANGED / INCORRECT_PRICE hata türü için geçerlidir.

availableQuantity

integer

Şu anda mevcut olan miktar. AVAILABILITY_CHANGED durumunda geçerlidir.

Hata Türü

Olası hata türleri.

Sıralamalar
ERROR_TYPE_UNSPECIFIED Bilinmeyen hata
NOT_FOUND Öğe bulunamadı. Öğe, Sipariş Karşılama Seçeneği, Promosyon olabilir. Varlık kimliği gerekiyor.
INVALID Öğe verileri geçerli değil. Öğe, FulfillmentOption, Promosyon olabilir. Varlık kimliği gerekiyor.
AVAILABILITY_CHANGED Öğe kullanılamıyor veya isteği yerine getirmek için yeterli öğe yok. Varlık kimliği gerekiyor.
PRICE_CHANGED Öğe fiyatı, Öğe varlığındaki fiyattan farklı. Varlık kimliği ve güncellenmiş fiyat gerekiyor.
INCORRECT_PRICE Ücretler'deki fiyat hataları, Toplam. Varlık kimliği ve güncellenmiş fiyat gerekiyor.
REQUIREMENTS_NOT_MET Sipariş kabul etmeyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.).
TOO_LATE FulfillmentOption alanının süresi doldu.
NO_CAPACITY Kullanılabilir hizmet kapasitesi yok. Daha ayrıntılı hata türlerinin hiçbiri geçerli değilse bu hata kodunu kullanın.
NO_COURIER_AVAILABLE Teslimat kuryesi bulunamadı. NO_CAPACITY olarak sınıflandırılabilecek ayrıntılı hata türü.
INELIGIBLE Kullanıcı sipariş vermeye uygun değil (kara listeye eklenmiş).
OUT_OF_SERVICE_AREA Sınır kuralları vb. nedeniyle istenen adrese teslimat yapılamıyor.
CLOSED Restoran işletme nedeniyle sipariş tarihinde kapalıdır.
PROMO_NOT_APPLICABLE Aşağıdakilerin hiçbirinin geçerli olmadığı durumlarda promosyon kodu uygulanamadığında tüm yakalanan genel hata kodu. Varlık kimliği olarak promosyon kodunu ekleyin.
PROMO_NOT_RECOGNIZED Kupon kodu iş ortağı tarafından tanınmadı. Varlık kimliği olarak promosyon kodunu ekleyin.
PROMO_EXPIRED Promosyonun süresi dolduğundan başvuru yapılamadı. Varlık kimliği olarak promosyon kodunu ekleyin.
PROMO_USER_INELIGIBLE Geçerli kullanıcı bu kupon için uygun değil. Varlık kimliği olarak promosyon kodunu ekleyin.
PROMO_ORDER_INELIGIBLE Geçerli sipariş bu kupon için uygun değil. Varlık kimliği olarak promosyon kodunu ekleyin.
UNAVAILABLE_SLOT Önceden sipariş alanı kullanılamıyor.
FAILED_PRECONDITION Sipariş kabul etmeyle ilgili kısıtlamalar karşılanmadı (minimum sepet boyutu vb.).
PAYMENT_DECLINED Geçersiz ödeme.
MERCHANT_UNREACHABLE Satıcıya ulaşılamıyor. Bu, bir iş ortağı toplayıcıysa ve satıcıya ulaşamadığında yardımcı olur.
ACCOUNT_LINKING_FAILED Satıcı, kullanıcının Google hesabını kendi sistemindeki bir hesaba bağlamayı denedi ancak bunu yaparken bir hatayla karşılaştı.

BiletSiparişi Uzantısı

Film, spor gibi bilet siparişlerinin sipariş içerikleri.

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

object (TicketEvent)

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

Etkinlik Etkinliği

Tek bir etkinliği temsil eder.

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

enum (Type)

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

name

string

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

description

string

Etkinliğin açıklaması.

url

string

Etkinlik bilgilerinin URL'si.

location

object (Location)

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

eventCharacters[]

object (EventCharacter)

Bu etkinlikle ilgili karakterler. Bu, bir film etkinliğinin direktörleri veya aktörleri ya da bir konserin performansı gerçekleştirenler vb. olabilir.

startDate

object (Time)

Başlangıç zamanı.

endDate

object (Time)

Bitiş zamanı.

doorTime

object (Time)

Giriş saati, etkinlik başlangıç zamanından farklı olabilir. Örneğin, etkinlik 09:00'da başlar, ancak giriş saati 08:30'da olur.

Tür

Etkinliğin türü.

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

EtkinlikKarakteri

Tek bir etkinlik karakteri (ör. düzenleyen, performans gösteren vb.)

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

enum (Type)

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

name

string

Karakterin adı.

image

object (Image)

Karakterin resimleri.

Tür

Karakter türü.

Sıralamalar
TYPE_UNKNOWN Bilinmeyen tür.
ACTOR Aktör.
PERFORMER Sanatçı.
DIRECTOR Yönetmen.
ORGANIZER Düzenleyen.

Kullanıcı Bildirimi

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

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

string

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

text

string

Bildirimin içeriği. İzin verilen maksimum uzunluk 100 karakterdir.

Sonraki Sahne

Sonraki yürütülecek sahneyi temsil eder.

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

string

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

Oturum

Mevcut görüşme oturumuyla ilgili bilgileri içerir

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

string

Zorunlu. Geçerli görüşme oturumunun genel olarak benzersiz kimliği. Bu alan salt okunur durumdadır.

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 zaten tanımlanmış olan parametrelerle birleştirilir. Boş değerli parametreler oturumdan kaldırılır. Oturum depolama belgelerini inceleyin: https://developers.google.com/assistant/conversational/storage-session.

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

typeOverrides[]

object (TypeOverride)

İsteğe bağlı. Oturum kapsamlı türler. Oturum türü tanımları, mevcut türleri tamamlayabilir veya değiştirebilir. Tür adları benzersiz olmalıdır.

languageCode

string

Geçerli görüşme oturumunun dili. IETF BCP-47 dil kodunu (http://www.rfc-Editor.org/rfc/bcp/bcp47.txt) uygular. İşlem çok dilli özellikler kullanıyorsa kullanıcı yerel ayarından farklı olabilir. Örneğin, Handler_response.beklenen.dil_kodu ayarlandığında, sonraki tüm dönüşler için konuşma dilini değiştirir. Bu dil bu alana yansıtılır.

Tür Geçersiz Kılma

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

JSON gösterimi
{
  "name": string,
  "mode": enum (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 gerekir?

synonym

object (SynonymType)

Geçersiz Kılma Modu

Oturum varlık türü için değişiklik türleri.

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

Eş Anlamlı Türü

Eş anlamlıları olan bir türü gösterir.

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

object (Entry)

Zorunlu. Eş anlamlı kelime girişi listesi.

Giriş

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

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

string

Zorunlu. Girişin adı (ör. "bisiklet"). Geçerli bir tür değeri olarak yeniden tanımlanabilmesi için, bu alandaki girişin yinelenen eş anlamlılar alanına eklenmesi gerekir.

synonyms[]

string

Zorunlu. Girişin eş anlamlıları listesi (ör. "bisiklet", "döngü").

display

object (EntryDisplay)

İsteğe bağlı. Öğe görüntüsü bilgileri.

Giriş Ekranı

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

string

Zorunlu. Öğenin başlığı. Bu mesaja dokunulduğunda, kullanıcı yazmış gibi sohbet mesajında tekrar yayınlanır. Her başlık, koleksiyon öğeleri grubu arasında benzersiz olmalıdır.

description

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 öğesinin açıklama metninin altında görünen altbilgi metni. Üç satırlık metinle kesilmiş tek satır.

openUrl

object (OpenUrl)

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

Kullanıcı

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

JSON gösterimi
{
  "locale": string,
  "params": {
    string: value,
    ...
  },
  "accountLinkingStatus": enum (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) uygular. Ancak komut dosyası alt etiketi dahil değildir.

params

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

İsteğe bağlı. Geçerli kullanıcıyla ilişkili tüm parametrelerin listesi. Kullanıcı depolama alanı dokümanlarını inceleyin: https://developers.google.com/assistant/conversational/storage-user.

"key": value çift listesi 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 belirtir.

lastSeenTime

string (Timestamp format)

Bu kullanıcıyla son etkileşimin zaman damgası. Kullanıcı, temsilciyle daha önce etkileşimde bulunmadıysa bu alan çıkarılır.

Nanosaniye çözünürlükte ve dokuz adede kadar kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

engagement

object (Engagement)

Niyet abonelikleri de dahil olmak üzere mevcut kullanıcının etkileşimi.

packageEntitlements[]

object (PackageEntitlements)

Kullanıcının mevcut işlemle ilişkili Android paketiyle ilgili yararlanma hakları.

permissions[]

enum (Permission)

Kullanıcının bu işleme verdiği izinleri içerir.

Hesap Bağlama Durumu

Son kullanıcının, hesabını bu uygulamaya bağlamış olup olmadığını belirtir. Hesap bağlama dokümanlarına göz atın: https://developers.google.com/assistant/identity.

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

Kullanıcı Doğrulama Durumu

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

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

Etkileşim

Mevcut kullanıcının kaydolduğu etkileşim mekanizmaları hakkında salt okunur bilgiler sağlar. Örneğin, kullanıcının tekrar aynı niyetle abone olmasını istememek için hangi amaçların halihazırda abone olduğunu bilmek yararlı olabilir. Yani, bu bilgiler yalnızca kullanıcı henüz abone olmamışsa günlük güncellemeleri veya push bildirimlerini ayarlamak için koşullu olarak rota oluşturmak üzere kullanılabilir. Kullanıcı etkileşimi dokümanlarını inceleyin: https://developers.google.com/assistant/engagement.

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

object (IntentSubscription)

Kullanıcının push bildirimini etkinleştirdiği niyetlerin listesini içerir.

dailyUpdateIntents[]

object (IntentSubscription)

Kullanıcının günlük güncellemeyi etkinleştirdiği amaçların listesini içerir.

IntentAboneliği

Mevcut bir IntentAbonelik açıklaması.

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

string

Abone olunan niyetin adı.

contentTitle

string

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

PackageEntitlements

Bir paket adıyla ilgili kullanıcı yararlanma haklarının listesi. Dijital iyi işlem dokümanlarına göz atın: https://developers.google.com/assistant/transactions/digital/dev-guide-digital-non-consumables.

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

string

İşlem paketinde belirtilen Android paket adı.

entitlements[]

object (Entitlement)

Kullanıcının verilen paketteki yararlanma hakları.

Hak

Kullanıcının dijital yararlanma hakkını tanımlar.

JSON gösterimi
{
  "sku": string,
  "skuType": enum (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
Alanlar
sku

string

Ürün SKU'su Ücretli uygulama için paket adı, uygulama içi satın alma için Finsky docid'in son eki ve uygulama içi abonelik. Play InApp Billing API'deki getSku() ile eşleşir. Play InApp Faturalandırma belgelerini inceleyin: https://developer.android.com/google/play/billing.

skuType

enum (SkuType)

SKU türü.

inAppDetails

object (SignedData)

Yalnızca uygulama içi satın alma işlemleri ve uygulama içi aboneler için mevcuttur.

SKU Türü

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

İmzalıVeriler

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

object (Struct format)

Tüm uygulama içi satın alma verilerini JSON biçiminde içerir. Ayrıntılı bilgiyi https://developer.android.com/google/play/billing/billing_reference.html sayfasındaki 6. tabloda bulabilirsiniz.

inAppDataSignature

string

Play InApp Billing API'deki getPurchases() yöntemindeki IN_APP_DATA_SIGNATURE ile eşleşir.

İzin

İzin için olası değerler.

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

Ana sayfa

Kullanıcının hedef cihazının ait olduğu HomeGraph yapısını temsil eder.

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

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 ile ilgili belgelere göz atın: https://developers.google.com/assistant/conversational/storage-home.

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

Cihaz

Kullanıcının İşlem için istekte bulunmak üzere kullandığı cihazı gösterir.

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

enum (Capability)

Gerekli. Cihazın İşlem isteğinde bulunan özellikleri.

currentLocation

object (Location)

İsteğe bağlı. Kullanıcının cihaz konumu. Bu alan, yalnızca son kullanıcı tarafından konum izinleri verildikten sonra doldurulur. Ayrıntılı ve ayrıntılı izne bağlı olarak hangi alanların ayarlanacağıyla ilgili daha fazla ayrıntı için konum mesajına bakın. İzin belgelerine bakın: https://developers.google.com/assistant/conversational/permissions.

timeZone

object (TimeZone)

İsteğe bağlı. İstemci cihazla ilişkili saat dilimi. Tarih-saat değerlerini çözmek için kullanılabilir.

Kapasite

İstek sırasında cihaz yüzeyinin desteklediği özellikler.

Sıralamalar
UNSPECIFIED Belirtilmemiş cihaz özelliği.
SPEECH Cihaz, metin okuma veya SSML üzerinden kullanıcıyla konuşabilir.
RICH_RESPONSE Cihaz; kartlar, listeler ve tablolar gibi zengin yanıtları görüntüleyebilir.
LONG_FORM_AUDIO Cihaz, müzik ve podcast gibi uzun biçimli ses medyalarını oynatabilir.
INTERACTIVE_CANVAS Cihaz, etkileşimli bir tuval yanıtı gösterebilir.
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ı beklenir. Tam konum izni, "administrativeArea" ve "addressLines" gibi ek alanları doldurur.

TimeZone

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

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

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

İçerik

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

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

MedyaBağlamı

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.

Saniyede en fazla dokuz ondalık basamak içeren ve "s" ile sonlanan süre. Örnek: "3.5s"

index

integer

Medya yanıtındaki medya dosyaları listesinde geçerli etkin medya dosyasının 0 tabanlı dizini.

TuvalBağlamı

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

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

value (Value format)

İsteğe bağlı. Durum, üçüncü taraf etkileşimli tuval uygulaması tarafından ayarlandı. Bu ayar yalnızca istek için ayarlanır, yanıt için değil. Örneğin, bu bir yemek tarifi uygulamasıysa durum değeri : { "current_page" : 5, "last_page" : 3, } olabilir. Boyut sınırı 50 KB'tır.

Beklenen

Sonraki diyalog dönüşüyle ilgili beklentileri açıklar.

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

string

İşlemin, kullanıcının konuşmaya ağırlık verme kelimesinden beklediği kelime öbeklerinin listesi. En fazla 1.000 ifadeye izin verilir. Not: Bu alan, v2 API'deki BeklenenInput.speech_biasing_hints ile aynı anlama sahiptir.