- JSON gösterimi
- Kullanıcı
- KullanıcıProfili
- PackageEntitlement
- Yararlanma hakkı
- İmzalı Veriler
- Cihaz
- Yüzey
- Kapasite
- Görüşme
- Giriş
- Ham Giriş
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 ( |
Alanlar | |
---|---|
user |
Görüşmeyi başlatan kullanıcı. |
device |
Kullanıcının İşlem için etkileşim kurmak için kullandığı cihazla ilgili bilgiler. |
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 |
Görüşme kimliği ve görüşme jetonu gibi oturum verilerini muhafazaya alır. |
inputs[] |
İş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 |
İsteğin korumalı alan modunda işlenmesi gerekip gerekmediğini belirtir. |
availableSurfaces[] |
Yüzeyde devir için uygun yüzeyler. |
Kullanıcı
JSON gösterimi | |
---|---|
{ "idToken": string, "profile": { object ( |
Alanlar | |
---|---|
idToken |
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 |
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 |
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 verdiği izinleri içerir. |
locale |
İ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 |
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ının görüşmelerinde kalıcıdır). Dize en fazla 10.000 karakter uzunluğunda olabilir. |
packageEntitlements[] |
İşlem paketinde listelenen her paket adı (varsa) için kullanıcı yararlanma haklarının listesi. |
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 |
Kullanıcının Google hesabında belirtildiği şekilde tam adı. |
givenName |
Kullanıcının Google hesabında belirtilen adı. |
familyName |
Kullanıcının, Google hesabında belirtilen soyadı. Bu alanın boş olabileceğini unutmayın. |
Paketle Yararlanma Hakkı
Bir paket adıyla ilgili yararlanma haklarının listesi
JSON gösterimi | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Alanlar | |
---|---|
packageName |
İşlem paketindeki paket adıyla eşleşmelidir |
entitlements[] |
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 ( |
Alanlar | |
---|---|
sku |
Ü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 |
|
inAppDetails |
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 |
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 |
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 ( |
Alanlar | |
---|---|
location |
Enlem, boylam ve biçimlendirilmiş adres gibi gerçek cihaz konumunu temsil eder. |
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 ( |
Alanlar | |
---|---|
capabilities[] |
Talep sırasında yüzeyin desteklediği özelliklerin listesi (ör. |
Kapasite
Yüzeyin destekleyebildiği bir işlev birimini temsil eder.
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ü 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 |
type, görüşmenin yaşam döngüsündeki durumunu belirtir. |
conversationToken |
İş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 ( |
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ürleri sağlaması için birden fazla görüşmenin dönüşmesi gerekebilir. |
intent |
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ş |
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ı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 |
Son kullanıcının yazılı veya sözlü girişi. |
|
url |
Tetikleyen URL. |