- Representasi JSON
- Pengguna
- Profil Pengguna
- PaketEntitlement
- Hak
- SignedData
- Perangkat
- Permukaan
- Kemampuan
- Percakapan
- Input
- RawInput
AppRequest adalah permintaan yang dikirim oleh Asisten Google ke fulfillment untuk berinteraksi dengan Action. Versi API ditentukan di header HTTP. Untuk API versi 1, header berisi: Google-Assistant-API-Version: v1
. Untuk API versi 2, header berisi: Google-actions-API-Version: 2
. Untuk contoh penggunaan dalam tindakan di Google, lihat https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
Representasi JSON | |
---|---|
{ "user": { object ( |
Kolom | |
---|---|
user |
Pengguna yang memulai percakapan. |
device |
Informasi tentang perangkat yang digunakan pengguna untuk berinteraksi dengan Action. |
surface |
Informasi tentang platform yang berinteraksi dengan pengguna, misalnya apakah dapat menghasilkan audio atau memiliki layar. |
conversation |
Menyimpan data sesi seperti ID percakapan dan token percakapan. |
inputs[] |
Daftar input yang sesuai dengan input yang diharapkan yang ditentukan oleh Action. Untuk pemicu percakapan awal, input berisi informasi tentang cara pengguna memicu percakapan. |
isInSandbox |
Menunjukkan apakah permintaan harus ditangani dalam mode sandbox. |
availableSurfaces[] |
Permukaan tersedia untuk handoff lintas platform. |
Pengguna
Representasi JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Kolom | |
---|---|
idToken |
token yang mewakili identitas pengguna. Ini adalah token web Json, termasuk profil yang dienkode. Definisinya ada di https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Informasi tentang pengguna akhir. Beberapa kolom hanya tersedia jika pengguna telah memberikan izin untuk memberikan informasi ini ke Action. |
accessToken |
Token OAuth2 yang mengidentifikasi pengguna di sistem Anda. Hanya tersedia jika pengguna menautkan akunnya. |
permissions[] |
Berisi izin yang diberikan oleh pengguna untuk Action ini. |
locale |
Setelan lokalitas utama pengguna yang membuat permintaan. Mengikuti kode bahasa IETF BCP-47 http://www.RFC-editor.org/RFC/bcp/bcp47.txt Namun, subtag skrip tidak disertakan. |
lastSeen |
Stempel waktu interaksi terakhir dengan pengguna ini. Kolom ini akan dihilangkan jika pengguna belum pernah berinteraksi dengan agen. Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: |
userStorage |
Token buram yang disediakan oleh aplikasi yang dipertahankan di seluruh percakapan untuk pengguna tertentu. Ukuran maksimum string adalah 10 ribu karakter. |
packageEntitlements[] |
Daftar hak pengguna untuk setiap nama paket yang tercantum dalam paket Tindakan, jika ada. |
userVerificationStatus |
Menunjukkan status verifikasi pengguna. |
ProfilPengguna
Berisi info pribadi pengguna. Kolom hanya diisi jika pengguna memberikan izin ke Tindakan untuk kolom tertentu.
Representasi JSON | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Kolom | |
---|---|
displayName |
Nama lengkap pengguna seperti yang ditentukan di Akun Google mereka. Memerlukan izin |
givenName |
Nama depan pengguna seperti yang ditentukan di akun Google mereka. Memerlukan izin |
familyName |
Nama belakang pengguna seperti yang ditentukan di Akun Google mereka. Perhatikan bahwa kolom ini dapat kosong. Memerlukan izin |
PaketEntitlement
Daftar hak yang terkait dengan nama paket
Representasi JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Kolom | |
---|---|
packageName |
Harus cocok dengan nama paket dalam paket tindakan |
entitlements[] |
Daftar hak untuk aplikasi tertentu |
Kepemilikan hak
Menentukan hak digital pengguna. Jenis hak yang memungkinkan: aplikasi berbayar,pembelian dalam aplikasi, langganan dalam aplikasi.
Representasi JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Kolom | |
---|---|
sku |
SKU produk. Nama paket untuk aplikasi berbayar, akhiran Finsky docid untuk pembelian dalam aplikasi dan langganan dalam aplikasi. Mencocokkan getSku() di Play InApp Billing API. |
skuType |
|
inAppDetails |
Hanya ada untuk pembelian dalam aplikasi dan langganan dalam aplikasi. |
DataBertanda Tangan
Representasi JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Kolom | |
---|---|
inAppPurchaseData |
Mencocokkan INAPP_PURCHASE_DATA dari metode getPurchases(). Berisi semua data pembelian dalam aplikasi dalam format JSON. Lihat detailnya di tabel 6 pada https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Mencocokkan IN_APP_DATA_SIGNATURE dari metode getPurchases() di Play InApp Billing API. |
Perangkat
Informasi tentang perangkat yang digunakan pengguna untuk berinteraksi dengan Action.
Representasi JSON | |
---|---|
{
"location": {
object ( |
Kolom | |
---|---|
location |
Mewakili lokasi perangkat yang sebenarnya seperti lintang, bujur, dan alamat yang telah diformat. Memerlukan izin |
Platform
Informasi yang spesifik untuk platform klien Asisten Google berinteraksi dengan pengguna. Platform dibedakan dari perangkat karena beberapa platform Asisten mungkin berada di perangkat yang sama.
Representasi JSON | |
---|---|
{
"capabilities": [
{
object ( |
Kolom | |
---|---|
capabilities[] |
Daftar kemampuan yang didukung platform pada saat permintaan, misalnya |
Kemampuan
Mewakili unit fungsi yang dapat didukung oleh permukaan.
Representasi JSON | |
---|---|
{ "name": string } |
Kolom | |
---|---|
name |
Nama kemampuan, misalnya |
Percakapan
Representasi JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Kolom | |
---|---|
conversationId |
ID unik untuk percakapan multi-putar. ID ini ditetapkan untuk belokan pertama. Setelah itu, percakapan akan tetap sama hingga percakapan berikutnya dihentikan. |
type |
type menunjukkan status percakapan dalam siklus prosesnya. |
conversationToken |
Token buram yang ditentukan oleh Action dalam giliran percakapan terakhir. Solusi ini dapat digunakan oleh Action untuk melacak percakapan atau untuk menyimpan data terkait percakapan. |
Input
Representasi JSON | |
---|---|
{ "rawInputs": [ { object ( |
Kolom | |
---|---|
rawInputs[] |
Transkripsi input mentah dari setiap belokan percakapan. Beberapa percakapan mungkin diperlukan untuk tindakan di Google guna memberikan beberapa jenis input untuk Action. |
intent |
Menunjukkan niat pengguna. Untuk percakapan pertama, intent akan merujuk ke intent pemicu untuk Action. Untuk percakapan berikutnya, intent akan menjadi tindakan umum pada intent Google (diawali dengan 'tindakan'). Misalnya, jika input yang diharapkan adalah |
arguments[] |
Daftar nilai argumen yang diberikan untuk input yang diminta oleh Action. |
InputMentah
Representasi JSON | |
---|---|
{ "inputType": enum ( |
Kolom | ||
---|---|---|
inputType |
Menunjukkan cara pengguna memberikan input ini: respons yang diketik, respons suara, tidak ditentukan, dll. |
|
Kolom union input . Nilai input input yang sebenarnya hanya dapat berupa salah satu dari berikut ini: |
||
query |
Input yang diketik atau diucapkan dari pengguna akhir. |
|
url |
URL pemicu. |