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.

AppRequest

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

AppRequest, bir İşlemle etkileşimde bulunulabilmesi için Google Asistan tarafından bir istek karşılama işlemine gönderilen istektir. API sürümü, HTTP başlığında belirtilir. API sürüm 1 için başlık şunları içerir: Google-Assistant-API-Version: v1. API sürüm 2'nin başlığında şunlar bulunur: Google-actions-API-Version: 2. Bu işlemin Google'daki işlemlerde nasıl kullanıldığına ilişkin örnekler için https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json sayfasına bakın.

JSON gösterimi
{
  "user": {
    object (User)
  },
  "device": {
    object (Device)
  },
  "surface": {
    object (Surface)
  },
  "conversation": {
    object (Conversation)
  },
  "inputs": [
    {
      object (Input)
    }
  ],
  "isInSandbox": boolean,
  "availableSurfaces": [
    {
      object (Surface)
    }
  ]
}
Alanlar
user

object (User)

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

device

object (Device)

Kullanıcının İşlem için etkileşim kurmak için kullandığı cihazla ilgili bilgiler.

surface

object (Surface)

Kullanıcının etkileşimde bulunduğu yüzeyle ilgili bilgiler (ör. kullanıcının ses çıkışı veya ekran görüntüsü).

conversation

object (Conversation)

Görüşme kimliği ve görüşme jetonu gibi oturum verilerini muhafazaya alır.

inputs[]

object (Input)

İşlem tarafından belirtilen beklenen girişlere karşılık gelen giriş listesi. İlk görüşme tetikleyicisi için giriş, kullanıcının görüşmeyi nasıl tetiklediğine ilişkin bilgiler içerir.

isInSandbox

boolean

İsteğin korumalı alan modunda işlenmesi gerekip gerekmediğini belirtir.

availableSurfaces[]

object (Surface)

Yüzeyde devir için uygun yüzeyler.

Kullanıcı

JSON gösterimi
{
  "idToken": string,
  "profile": {
    object (UserProfile)
  },
  "accessToken": string,
  "permissions": [
    enum (Permission)
  ],
  "locale": string,
  "lastSeen": string,
  "userStorage": string,
  "packageEntitlements": [
    {
      object (PackageEntitlement)
    }
  ],
  "userVerificationStatus": enum (UserVerificationStatus)
}
Alanlar
idToken

string

kimliğini temsil eder. Bu, kodlanmış profil içeren bir Json web jetonudur. Tanım https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo adresindedir.

profile

object (UserProfile)

Son kullanıcıyla ilgili bilgiler. Bazı alanlar, yalnızca kullanıcı bu işlemin Action'a sağlanması için izin vermişse kullanılabilir.

accessToken

string

Sisteminizdeki kullanıcıyı tanımlayan bir OAuth2 jetonu. Yalnızca kullanıcı hesabını bağlarsa kullanılabilir.

permissions[]

enum (Permission)

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

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

lastSeen

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.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

userStorage

string

Uygulama tarafından sağlanan opak bir jeton (belirli bir kullanıcının görüşmelerinde kalıcıdır). Dize en fazla 10.000 karakter uzunluğunda olabilir.

packageEntitlements[]

object (PackageEntitlement)

İşlem paketinde listelenen her paket adı (varsa) için kullanıcı yararlanma haklarının listesi.

userVerificationStatus

enum (UserVerificationStatus)

Kullanıcının doğrulama durumunu belirtir.

KullanıcıProfili

Kullanıcının kişisel bilgilerini içerir. Alanlar, yalnızca kullanıcı, belirli bir alan için Action'a izin verdiğinde doldurulur.

JSON gösterimi
{
  "displayName": string,
  "givenName": string,
  "familyName": string
}
Alanlar
displayName

string

Kullanıcının Google hesabında belirtildiği şekilde tam adı. NAME izni gerektirir.

givenName

string

Kullanıcının Google hesabında belirtilen adı. NAME izni gerektirir.

familyName

string

Kullanıcının, Google hesabında belirtilen soyadı. Bu alanın boş olabileceğini unutmayın. NAME izni gerektirir.

Paketle Yararlanma Hakkı

Bir paket adıyla ilgili yararlanma haklarının listesi

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

string

İşlem paketindeki paket adıyla eşleşmelidir

entitlements[]

object (Entitlement)

Belirli bir uygulama için yararlanma haklarının listesi

Hak

Kullanıcının dijital yararlanma hakkını tanımlar. Olası yararlanma türleri: ücretli uygulama,uygulama içi satın alma işlemleri, uygulama içi abonelikler.

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.

skuType

enum (SkuType)

inAppDetails

object (SignedData)

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

İmzalıVeriler

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

object (Struct format)

getPurchases() yönteminden INAPP_PURCHASE_DATA ile eşleşme. Tüm uygulama içi satın alma verilerini JSON biçiminde içerir https://developer.android.com/google/play/billing/billing_reference.html sayfasının 6. tablosundaki ayrıntıları inceleyin.

inAppDataSignature

string

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

Cihaz

Kullanıcının İşlem için etkileşim kurmak için kullandığı cihazla ilgili bilgiler.

JSON gösterimi
{
  "location": {
    object (Location)
  }
}
Alanlar
location

object (Location)

Enlem, boylam ve biçimlendirilmiş adres gibi gerçek cihaz konumunu temsil eder. DEVICE_COARSE_LOCATION veya DEVICE_PRECISE_LOCATION izni gerektirir.

Yüzey

Kullanıcının etkileşimde bulunduğu Google Asistan istemcisine özel bilgiler. Yüzey, cihazdan farklı olarak birden fazla Asistan yüzeyinin aynı cihazda bulunabilir olmasından ayırt edilir.

JSON gösterimi
{
  "capabilities": [
    {
      object (Capability)
    }
  ]
}
Alanlar
capabilities[]

object (Capability)

Talep sırasında yüzeyin desteklediği özelliklerin listesi (ör. actions.capability.AUDIO_OUTPUT)

Kapasite

Yüzeyin destekleyebildiği bir işlev birimini temsil eder.

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

string

Özelliğin adı (ör. actions.capability.AUDIO_OUTPUT)

Konuşma

JSON gösterimi
{
  "conversationId": string,
  "type": enum (ConversationType),
  "conversationToken": string
}
Alanlar
conversationId

string

Çok dönüşlü görüşme için benzersiz kimlik. İlk dönüş için atanır. Bunun ardından, görüşme sonlandırılana kadar sonraki görüşme için aynı şekilde kalır.

type

enum (ConversationType)

type, görüşmenin yaşam döngüsündeki durumunu belirtir.

conversationToken

string

İşlem tarafından son görüşme dönüşünde belirtilen opak jeton. Bir İşlem tarafından görüşmeyi takip etmek veya görüşmeyle ilgili verileri depolamak için kullanılabilir.

Giriş

JSON gösterimi
{
  "rawInputs": [
    {
      object (RawInput)
    }
  ],
  "intent": string,
  "arguments": [
    {
      object (Argument)
    }
  ]
}
Alanlar
rawInputs[]

object (RawInput)

Her görüşmeden sonraki işlenmemiş girişleri metne dönüştürme. Google'daki işlemlerin, Action'a bazı giriş türleri sağlaması için birden fazla görüşmenin dönüşmesi gerekebilir.

intent

string

Kullanıcının amacını belirtir. İlk görüşmede amaç, İşlem için tetikleme niyetini ifade eder. Sonraki görüşme dönüşlerinde amaç, Google niyetine ilişkin yaygın bir işlem ("işlemler" ile başlar) olacaktır. Örneğin, beklenen giriş actions.intent.OPTION ise burada belirtilen amaç, Google Asistan bu amacı karşılamışsa actions.intent.OPTION veya kullanıcı başka bilgiler sağladıysa actions.intent.TEXT olur. https://developers.google.com/assistant/df-asdk/reference/intents sayfasına bakın.

arguments[]

object (Argument)

İşlem tarafından istenen giriş için sağlanan bağımsız değişken değerlerinin listesi.

Ham Giriş

JSON gösterimi
{
  "inputType": enum (InputType),

  // Union field input can be only one of the following:
  "query": string,
  "url": string
  // End of list of possible types for union field input.
}
Alanlar
inputType

enum (InputType)

Kullanıcının bu girişi nasıl sağladığını gösterir: yazılı yanıt, sesli yanıt, belirtilmedi vb.

Birlik alanı input. Gerçek giriş değeri (input) aşağıdakilerden yalnızca biri olabilir:
query

string

Son kullanıcının yazılı veya sözlü girişi.

url

string

Tetikleyen URL.