- JSON gösterimi
- Kullanıcı
- UserProfile
- PackageEntitlement
- Yararlanma hakkı
- SignedData
- Cihaz
- Yüzey
- Kapasite
- İleti dizisi
- Giriş
- RawInput
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 ( |
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üzeyle ilgili bilgiler (ör. ses çıkışının olup olmadığı veya ekran içerip içermediği). |
conversation |
Görüşme kimliği ve görüşme jetonu gibi oturum verilerini saklar. |
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 ileti dizisini nasıl tetiklediğine ilişkin bilgiler içerir. |
isInSandbox |
İsteğin korumalı alan modunda işlenmesi gerekip gerekmediğini belirtir. |
availableSurfaces[] |
Yüzeyler arası aktarım için uygun yüzeyler. |
Kullanıcı
JSON gösterimi | |
---|---|
{ "idToken": string, "profile": { object ( |
Alanlar | |
---|---|
idToken |
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 |
Son kullanıcı hakkında bilgiler. Bazı alanlar yalnızca kullanıcı işleme bu bilgileri sağlamaya izin verdiyse 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 İşlem için verdiği izinleri içerir. |
locale |
İ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 |
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: |
userStorage |
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[] |
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. |
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 |
Kullanıcının Google hesabında belirtildiği şekliyle tam adı. |
givenName |
Kullanıcının Google hesabında belirtildiği şekliyle adı. |
familyName |
Kullanıcının Google hesabında belirtildiği şekliyle soyadı. Bu alanın boş olabileceğini unutmayın. |
PackageEntitlement
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 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 ( |
Alanlar | |
---|---|
sku |
Ü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 |
|
inAppDetails |
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 |
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 |
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 ( |
Alanlar | |
---|---|
location |
Enlem, boylam ve biçimlendirilmiş adres gibi gerçek cihaz konumunu temsil eder. |
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 ( |
Alanlar | |
---|---|
capabilities[] |
Platformun istek sırasında desteklediği özelliklerin listesi (ör. |
Kapasite
Yüzeyin destekleyebildiği işlevsellik birimini temsil eder.
JSON gösterimi | |
---|---|
{ "name": string } |
Alanlar | |
---|---|
name |
Özelliğin adı, ör. |
Etkileşim
JSON gösterimi | |
---|---|
{
"conversationId": string,
"type": enum ( |
Alanlar | |
---|---|
conversationId |
Ç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 |
type , ileti dizisinin yaşam döngüsündeki durumunu belirtir. |
conversationToken |
İş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 ( |
Alanlar | |
---|---|
rawInputs[] |
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 |
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ş |
arguments[] |
İşlem tarafından istenen giriş için sağlanan bağımsız değişken değerlerinin listesi. |
RawInput
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. |
|
input alanı. input olan gerçek giriş değeri aşağıdakilerden yalnızca biri olabilir: |
||
query |
Son kullanıcının yazılı veya sözlü olarak yaptığı girişler. |
|
url |
Tetikleyen URL. |