AppRequest

AppRequest, bir İşlemle etkileşimde bulunmak için Google Asistan tarafından istek karşılamaya gönderilen bir istektir. API sürümü, HTTP başlığında belirtilir. API 1 sürümü için başlık şunları içeriyor: Google-Assistant-API-Version: v1. API sürüm 2 için başlık şunları içerir: Google-actions-API-Version: 2. Bu işlemin Google'daki işlemlerde nasıl kullanıldığına dair ö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 İşlemle etkileşimde bulunmak için kullandığı cihazla ilgili bilgiler.
surface

object (Surface)

Kullanıcının etkileşimde bulunduğu yüzey hakkında bilgiler. Örneğin, kullanıcının ses verip vermediği veya ekran kullanıp kullanmadığı.
conversation

object (Conversation)

Görüşme kimliği ve görüşme jetonu gibi oturum verilerini içerir.
inputs[]

object (Input)

İşlem tarafından belirtilen beklenen girişlere karşılık gelen girişlerin listesi. İlk görüşme tetikleyicisi için giriş, kullanıcının görüşmeyi nasıl tetiklediği hakkında bilgi içerir.
isInSandbox

boolean

İsteğin korumalı alan modunda işlenip işlenmeyeceğini belirtir.
availableSurfaces[]

object (Surface)

Yüzeyde aktarma 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

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

object (UserProfile)

Son kullanıcı hakkında bilgi. Bazı alanlar yalnızca kullanıcı bu bilgileri İşleme sunmak 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 izin verdiği izinleri içerir.
locale

string

İstekte bulunan kullanıcının birincil yerel ayar ayarı. IETF BCP-47 dil kodunu uygular http://www.rfc-editor.org/rfc/bcp/bcp47.txt Ancak komut dosyası alt etiketi dahil değildir.
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ı için görüşmelerde saklanır. Dizenin maksimum boyutu 10.000 karakterdir.
packageEntitlements[]

object (PackageEntitlement)

Varsa, İşlem paketinde listelenen her paket adı için kullanıcı yararlanma haklarının listesi.
userVerificationStatus

enum (UserVerificationStatus)

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

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 verirse doldurulur.

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

string

Kullanıcının Google Hesabı'nda belirtilen 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 belirtildiği soyadı. Bu alanın boş olabileceğini unutmayın. NAME izni gerektirir.

PackageEntitlement

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 aynı olmalıdır
entitlements[]

object (Entitlement)

Belirli bir uygulamanın yararlanma hakları 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 docidinin son eki ve uygulama içi abonelik. Play InApp Billing API'de getSku() parametresini kullanın.
skuType

enum (SkuType)
inAppDetails

object (SignedData)

Yalnızca uygulama içi satın alma ve uygulama içi aboneler için kullanılabilir.

İmzalanmışVeri

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

object (Struct format)

getPurchases() yöntemindeki INAPP_PURCHASE_DATA ile eşleşir. 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önteminden IN_APP_DATA_SIGNATURE ile eşleşir.

Cihaz

Kullanıcının İşlemle etkileşimde bulunmak 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 gösterir. DEVICE_COARSE_LOCATION veya DEVICE_PRECISE_LOCATION izni gerektirir.

Yüzey

Kullanıcının etkileşimde bulunduğu Google Asistan istemcisine özel bilgiler. Aynı cihazda birden fazla Asistan yüzeyinin bulunabilmesi sayesinde yüzeyler cihazdan ayırt edilir.

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

object (Capability)

İstek sırasında yüzeyin desteklediği özelliklerin listesi. Örneğin, actions.capability.AUDIO_OUTPUT

Kapasite

Yüzeylerin destekleyebildiği bir işlev birimini gösterir.

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ü ileti dizisinin benzersiz kimliği. İlk dönüş için atanır. Bu adımdan sonra, sonraki bir görüşme bitene kadar aynı şekilde devam eder.
type

enum (ConversationType)

type, sohbetin yaşam döngüsündeki durumunu gösterir.
conversationToken

string

Son görüşme sırasında İşlem tarafından belirtilen opak jeton. Bir İşlem tarafından görüşmeyi izlemek 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ürlerini sağlaması için birden fazla görüşme turu gerekebilir.
intent

string

Kullanıcının amacını belirtir. İlk görüşmede amaç, İşlem'in tetikleyici amacını belirtir. İleti dizisinin sonraki ileti dizilerinde amaç, Google amacı üzerinde sık yapılan bir işlemdir ("işlemler" ile başlar). Örneğin, beklenen giriş actions.intent.OPTION ise burada belirtilen amaç, Google Asistan bu amacı yerine getirebildiyse actions.intent.OPTION, kullanıcı başka bilgi sağladıysa actions.intent.TEXT olur. https://developers.google.com/assistant/df-asdk/reference/intents adresine 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ılan yanıt, sesli yanıt, belirtilmedi.
Birlik alanı input. Gerçek giriş değeri (input) aşağıdakilerden yalnızca biri olabilir:
query

string

Son kullanıcının yazdığı veya yazdığı sesli giriş.
url

string

Tetikleyici URL.