AppRequest

AppRequest, bir İşlem ile etkileşim kurmak için Google Asistan tarafından bir istek karşılamaya 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 için başlık şunları içerir: Google-actions-API-Version: 2. Bunun 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 İşlemle etkileşimde bulunmak için kullandığı cihazla ilgili bilgiler.

surface

object (Surface)

Kullanıcının etkileşimde bulunduğu yüzeyle ilgili bilgiler (ör. ses çıkışının olup olmadığı veya ekran içerip içermediği).

conversation

object (Conversation)

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

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 ileti dizisini 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üzeyler arası aktarım 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

Kullanıcı kimliğini temsil eden jeton. Bu, kodlanmış profil içeren bir Json web jetonudur. Tanım için https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo adresini ziyaret edebilirsiniz.

profile

object (UserProfile)

Son kullanıcı hakkında bilgiler. Bazı alanlar yalnızca kullanıcı işleme bu bilgileri sağlamaya izin 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ının bu İşlem için verdiği izinleri içerir.

locale

string

İsteği yapan kullanıcının birincil yerel ayarı. IETF BCP-47 dil kodu http://www.rfc-editor.org/rfc/bcp/bcp47.txt'yi izler ancak komut dosyası alt etiketi dahil edilmez.

lastSeen

string (Timestamp format)

Bu kullanıcıyla gerçekleştirilen son etkileşimin zaman damgası. Kullanıcı daha önce aracıyla 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ı için görüşmelerde kalıcı olan opak jeton. 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.

UserProfile

Kullanıcının kişisel bilgilerini içerir. Alanlar, yalnızca kullanıcı belirli bir alan için işleme izin verirse doldurulur.

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

string

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

givenName

string

Kullanıcının Google hesabında belirtildiği şekliyle adı. NAME iznini gerektirir.

familyName

string

Kullanıcının Google hesabında belirtildiği şekliyle 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 uygulamanın yararlanma haklarının listesi

Hak

Kullanıcının dijital yararlanma hakkını tanımlar. Olası yararlanma hakkı 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 ve uygulama içi abonelikler için sunulur.

SignedData

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

object (Struct format)

INAPP_PURCHASE_DATA verisini getPurchases() yönteminden eşleştirin. Tüm uygulama içi satın alma verilerini JSON biçiminde içerir. Ayrıntıları https://developer.android.com/google/play/billing/billing_reference.html sayfasında, 6. tabloda bulabilirsiniz.

inAppDataSignature

string

Play InApp Faturalandırma API'sindeki getPurchases() yöntemindeki 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 temsil eder. DEVICE_COARSE_LOCATION veya DEVICE_PRECISE_LOCATION iznini gerektirir.

Platform

Kullanıcının etkileşimde bulunduğu Google Asistan istemcisi yüzeyine özel bilgiler. Yüzey, aynı cihazda birden fazla Asistan yüzeyinin bulunabilmesinden dolayı cihazdan ayrılır.

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

object (Capability)

Platformun istek sırasında desteklediği özelliklerin listesi (ör. actions.capability.AUDIO_OUTPUT)

Kapasite

Yüzeyin destekleyebildiği işlevsellik birimini temsil eder.

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

string

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

Etkileşim

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

string

Çok dönüşlü görüşmenin benzersiz kimliği. İlk dönüş için atanmıştır. Sonrasında, görüşme sonlandırılana kadar sonraki görüşme dönüşlerinde aynı kalır.

type

enum (ConversationType)

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

conversationToken

string

İşlemin son ileti dizisinde belirttiği opak jeton. Bir iş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 konuşmanın ham girdi transkripti. Google'daki işlemlerin işleme bazı girdiler sağlaması için birden fazla kez konuşmalar olması gerekebilir.

intent

string

Kullanıcının niyetini gösterir. Görüşmenin ilk dönüşünde amaç, işlemin tetikleme niyetine işaret eder. Sonraki görüşmelerde amaç, Google amacı ile ilgili yaygın işlemler ("işlemler" ile başlar) olacaktır. Örneğin, beklenen giriş actions.intent.OPTION ise burada belirtilen amaç, Google Asistan bu niyeti 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ı gösterir: yazılı yanıt, sesli yanıt, belirtilmedi vb.

input alanı. input olan gerçek giriş değeri aşağıdakilerden yalnızca biri olabilir:
query

string

Son kullanıcının yazılı veya sözlü olarak yaptığı girişler.

url

string

Tetikleyen URL.