- Representasi JSON
- Pengguna
- UserProfile
- PackageEntitlement
- Hak
- SignedData
- Perangkat
- Permukaan
- Kemampuan
- Percakapan
- Masukan
- RawInput
AppRequest adalah permintaan yang dikirim oleh Asisten Google ke fulfillment untuk berinteraksi dengan Action. Versi API ditetapkan di header HTTP. Untuk API versi 1, header-nya berisi: Google-Assistant-API-Version: v1
. Untuk API versi 2, header-nya berisi: Google-actions-API-Version: 2
. Untuk contoh cara penggunaannya 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, mis. apakah perangkat 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 yang tersedia untuk handoff lintas permukaan. |
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 sebelumnya. 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 Action, jika ada. |
userVerificationStatus |
Menunjukkan status verifikasi pengguna. |
UserProfile
Berisi info pribadi pengguna. Kolom hanya diisi jika pengguna memberikan izin kepada Action 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 boleh kosong. Memerlukan izin |
PackageEntitlement
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 |
Hak
Menentukan hak digital pengguna. Jenis kemungkinan hak: 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. Cocokkan getSku() di API Penagihan InApp Play. |
skuType |
|
inAppDetails |
Hanya ada untuk pembelian dalam aplikasi dan pelanggan dalam aplikasi. |
SignedData
Representasi JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Kolom | |
---|---|
inAppPurchaseData |
Cocokkan INAPP_PURCHASE_DATA dari metode getPurchases(). Berisi semua data pembelian dalam aplikasi dalam format JSON Lihat detail dalam tabel 6 di 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 sebenarnya seperti lintang, bujur, dan alamat berformat. Memerlukan izin |
Platform
Informasi khusus untuk klien Asisten Google menunjukkan pengguna yang berinteraksi. Platform dibedakan dengan 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 fungsionalitas yang dapat didukung oleh platform.
Representasi JSON | |
---|---|
{ "name": string } |
Kolom | |
---|---|
name |
Nama kemampuan, misalnya |
Percakapan
Representasi JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Kolom | |
---|---|
conversationId |
ID unik untuk percakapan multi-giliran. Ditugaskan untuk belokan pertama. Setelah itu, tampilan jam akan tetap sama untuk percakapan berikutnya hingga percakapan dihentikan. |
type |
menunjukkan status percakapan dalam siklus hidupnya. |
conversationToken |
Token tidak transparan yang ditentukan oleh Action di belokan percakapan terakhir. Ini dapat digunakan oleh Action untuk melacak percakapan atau menyimpan data terkait percakapan. |
Input
Representasi JSON | |
---|---|
{ "rawInputs": [ { object ( |
Kolom | |
---|---|
rawInputs[] |
Transkripsi input mentah dari setiap percakapan. Beberapa perubahan percakapan mungkin diperlukan agar Action di Google dapat memberikan beberapa jenis input ke Action. |
intent |
Menunjukkan intent pengguna. Untuk giliran percakapan pertama, intent akan merujuk pada intent pemicu untuk Action tersebut. Untuk percakapan berikutnya, intent akan berupa tindakan umum pada intent Google (dimulai dengan 'actions'). Misalnya, jika input yang diharapkan adalah |
arguments[] |
Daftar nilai argumen yang diberikan untuk input yang diminta oleh Action. |
RawInput
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 sebenarnya input hanya dapat berupa salah satu dari yang berikut: |
||
query |
Input lisan atau yang diketik dari pengguna akhir. |
|
url |
URL pemicu. |