- JSON gösterimi
- Kullanıcı
- Kullanıcı Profili
- PackageEntitlement
- Yararlanma hakkı
- İmzalıVeri
- Cihaz
- Yüzey
- Yetenek
- Görüşme
- Giriş
- Ham girişi
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 ( |
Alanlar | |
---|---|
user |
Görüşmeyi başlatan kullanıcı. |
device |
Kullanıcının İşlemle etkileşimde bulunmak için kullandığı cihazla ilgili bilgiler. |
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 |
Görüşme kimliği ve görüşme jetonu gibi oturum verilerini içerir. |
inputs[] |
İş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 |
İsteğin korumalı alan modunda işlenip işlenmeyeceğini belirtir. |
availableSurfaces[] |
Yüzeyde aktarma için uygun yüzeyler. |
Kullanıcı
JSON gösterimi | |
---|---|
{ "idToken": string, "profile": { object ( |
Alanlar | |
---|---|
idToken |
jetonunu temsil eder. Bu, kodlanmış profil içeren bir Json web jetonudur. Tanım, https://developers.google.com/identity/Protokols/OpenIDConnect#obtainuserinfo adresindedir. |
profile |
Son kullanıcı hakkında bilgi. Bazı alanlar yalnızca kullanıcı bu bilgileri İşleme sunmak için izin vermişse kullanılabilir. |
accessToken |
Sisteminizdeki kullanıcıyı tanımlayan bir OAuth2 jetonu. Yalnızca kullanıcı hesabını bağlarsa kullanılabilir. |
permissions[] |
Kullanıcının bu işleme izin verdiği izinleri içerir. |
locale |
İ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 |
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: |
userStorage |
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[] |
Varsa, İşlem paketinde listelenen her paket adı için kullanıcı yararlanma haklarının listesi. |
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 |
Kullanıcının Google Hesabı'nda belirtilen tam adı. |
givenName |
Kullanıcının Google Hesabı'nda belirtilen adı. |
familyName |
Kullanıcının Google hesabında belirtildiği soyadı. Bu alanın boş olabileceğini unutmayın. |
PackageEntitlement
Bir paket adıyla ilgili yararlanma haklarının listesi
JSON gösterimi | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Alanlar | |
---|---|
packageName |
İşlem paketindeki paket adıyla aynı olmalıdır |
entitlements[] |
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 ( |
Alanlar | |
---|---|
sku |
Ü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 |
|
inAppDetails |
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 |
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 |
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 ( |
Alanlar | |
---|---|
location |
Enlem, boylam ve biçimlendirilmiş adres gibi gerçek cihaz konumunu gösterir. |
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 ( |
Alanlar | |
---|---|
capabilities[] |
İstek sırasında yüzeyin desteklediği özelliklerin listesi. Örneğin, |
Kapasite
Yüzeylerin destekleyebildiği bir işlev birimini gösterir.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Özelliğin adı (ör. |
Konuşma
JSON gösterimi | |
---|---|
{
"conversationId": string,
"type": enum ( |
Alanlar | |
---|---|
conversationId |
Ç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 |
type, sohbetin yaşam döngüsündeki durumunu gösterir. |
conversationToken |
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 ( |
Alanlar | |
---|---|
rawInputs[] |
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 |
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ş |
arguments[] |
İş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 ( |
Alanlar | ||
---|---|---|
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 |
Son kullanıcının yazdığı veya yazdığı sesli giriş. |
|
url |
Tetikleyici URL. |