AppRequest

AppRequest, bir İşlemle etkileşimde bulunması için Google Asistan tarafından sipariş karşılamaya gönderilen bir 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 için başlık şunları içerir: Google-actions-API-Version: 2. Bu bilgilerin Google'daki işlemlerde nasıl kullanıldığına dair örnekler için https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json adresine 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 ile etkileşimde bulunmak için kullandığı cihazla ilgili bilgiler.
surface

object (Surface)

Kullanıcının etkileşim kurduğu yüzeyle ilgili bilgiler, ör. ve ekranlarının olup olmadığını kontrol edin.
conversation

object (Conversation)

Görüşme kimliği ve görüşme jetonu gibi oturum verilerini muhafaza eder.
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ğine ilişkin bilgileri içerir.
isInSandbox

boolean

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

object (Surface)

Çapraz yüzey aktarımı için kullanılabilecek 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

kullanıcının kimliğini temsil eden jeton. Bu, kodlanmış profil içeren bir Json web jetonudur. Tanımı https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo adresinde bulabilirsiniz.
profile

object (UserProfile)

Son kullanıcı hakkında bilgiler. Bazı alanlar yalnızca kullanıcı bu bilgileri Action'a sağlama izni verdiyse 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ı tarafından bu İşlem için verilen izinleri içerir.
locale

string

İstekte bulunan kullanıcının birincil yerel ayarı. http://www.rfc-editor.org/rfc/bcp/bcp47.txt IETF BCP-47 dil kodunu izler ancak komut dosyası alt etiketi dahil edilmemiştir.
lastSeen

string (Timestamp format)

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

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

string

Uygulama tarafından sağlanan ve belirli bir kullanıcının ileti dizileri arasında kalıcı olan opak bir jeton. Dizenin maksimum boyutu 10.000 karakterdir.
packageEntitlements[]

object (PackageEntitlement)

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

enum (UserVerificationStatus)

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

UserProfile

Kullanıcının kişisel bilgilerini içerir. Alanlar, yalnızca kullanıcı kullanıcı belirli bir alan için İşlem için 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 iznini gerektirir.
givenName

string

Kullanıcının Google Hesabı'nda belirtilen adı. NAME iznini gerektirir.
familyName

string

Kullanıcının Google Hesabı'nda belirtilen soyadı. Bu alanın boş olabileceğini unutmayın. NAME iznini gerektirir.

PackageEntitlement

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 haklarını tanımlar. Olası yararlanma hakları 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 ve uygulama içi abonelik için Finsky docid son eki. Play InApp Faturalandırma API'sinde getSku() ile eşleştirin.
skuType

enum (SkuType)
inAppDetails

object (SignedData)

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

SignedData

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

object (Struct format)

INAPP_PURCHASE_DATA öğesini getPurchases() yönteminden eşleştirin. Tüm uygulama içi satın alma verilerini JSON biçiminde içerir. Ayrıntılar için https://developer.android.com/google/play/billing/billing_reference.html adresindeki 6. tabloya bakın.
inAppDataSignature

string

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

Cihaz

Kullanıcının İşlem ile 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 iznini gerektirir.

Platform

Google Asistan istemcisine özgü bilgiler, kullanıcının etkileşime girdiğini gösterir. Yüzey, aynı cihazda birden fazla Asistan yüzeyinin bulunabilmesi sayesinde cihazdan ayrılır.

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

object (Capability)

Yüzeyin istek sırasında desteklediği özelliklerin listesi (ör. actions.capability.AUDIO_OUTPUT.

Kapasite

Yüzeyin destekleyebildiği 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ü ileti dizisinin benzersiz kimliği. İlk dönüş için atanmış. Daha sonra, görüşme sonlandırılana kadar sonraki görüşme için aynı kalır.
type

enum (ConversationType)

type , ileti dizisinin yaşam döngüsündeki durumunu belirtir.
conversationToken

string

Son görüşme sırasında İşlem tarafından belirtilen opak jeton. Bir İşlem tarafından görüşmeyi izlemek veya ileti dizisiyle ilgili verileri saklamak için kullanılabilir.

Giriş

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

object (RawInput)

Her görüşmede ham girdiyi metne dönüştürme. Google'daki işlemlerin İşlem'e bazı giriş türlerini sağlaması için birden fazla görüşme gerekebilir.
intent

string

Kullanıcının niyetini belirtir. İlk görüşmede amaç, İşlemin tetikleme amacını ifade eder. Görüşmenin ilerleyen aşamalarında amaç, Google amacına yönelik sık kullanılan bir işlem olacaktır ("işlemler" ile başlar). Örneğin, beklenen giriş actions.intent.OPTION ise burada belirtilen amaç, Google Asistan bu amacı karşılayabildiyse 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 adresine göz atın.
arguments[]

object (Argument)

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

RawInput

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ı belirtir: yazılan yanıt, sesli yanıt, belirtilmemiş vb.
Birleştirme alanı input. Gerçek giriş değeri (input) aşağıdakilerden yalnızca biri olabilir:
query

string

Son kullanıcının yazması veya sözlü girişi.
url

string

Tetikleyici URL.