- Representación JSON
- Usuario
- UserProfile
- PackageEntitlement
- Derecho
- SignedData
- Dispositivo
- Superficie
- Función
- Conversación
- Entrada
- RawInput
AppRequest es una solicitud que envía Asistente de Google a una entrega para interactuar con una acción. La versión de la API se especifica en el encabezado HTTP. Para la versión 1 de la API, el encabezado contiene: Google-Assistant-API-Version: v1
. Para la versión 2 de la API, el encabezado contiene: Google-actions-API-Version: 2
. Para ver ejemplos de cómo se usa este método en Actions on Google, consulta https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
Representación JSON | |
---|---|
{ "user": { object ( |
Campos | |
---|---|
user |
El usuario que inició la conversación. |
device |
Es la información sobre el dispositivo que el usuario usa para interactuar con la acción. |
surface |
Información sobre la superficie con la que interactúa el usuario, p.ej., si puede transmitir audio o tiene pantalla. |
conversation |
Contiene datos de sesión, como el ID y el token de la conversación. |
inputs[] |
Lista de entradas que corresponden a las entradas esperadas que especifica la acción. Para el activador inicial de la conversación, la entrada contiene información sobre cómo el usuario activó la conversación. |
isInSandbox |
Indica si la solicitud debe manejarse en el modo de zona de pruebas. |
availableSurfaces[] |
Superficies disponibles para transferencia entre superficies. |
Usuario
Representación JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Campos | |
---|---|
idToken |
token que representa la identidad del usuario. Este es un token web JSON que incluye el perfil codificado. La definición está en https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Información sobre el usuario final. Algunos campos solo están disponibles si el usuario otorgó permiso para proporcionar esta información a la acción. |
accessToken |
Un token de OAuth2 que identifica al usuario en tu sistema. Solo está disponible si el usuario vincula su cuenta. |
permissions[] |
Contiene los permisos otorgados por el usuario para esta acción. |
locale |
Es la configuración regional principal del usuario que realiza la solicitud. Sigue el código de idioma IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt Sin embargo, no se incluye la subetiqueta de la secuencia de comandos. |
lastSeen |
La marca de tiempo de la última interacción con este usuario. Este campo se omitirá si el usuario no interactuó antes con el agente. Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: |
userStorage |
Un token opaco proporcionado por la aplicación que se conserva en las conversaciones de un usuario en particular. El tamaño máximo de la cadena es de 10,000 caracteres. |
packageEntitlements[] |
Lista de derechos del usuario para cada nombre de paquete del paquete de acción, si corresponde. |
userVerificationStatus |
Indica el estado de verificación del usuario. |
UserProfile
Contiene la información personal del usuario. Los campos solo se propagan si el usuario otorga permiso a la acción para un campo en particular.
Representación JSON | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Campos | |
---|---|
displayName |
El nombre completo del usuario, como se especifica en su Cuenta de Google. Requiere el permiso |
givenName |
Indica el nombre del usuario, tal como se especifica en su Cuenta de Google. Requiere el permiso |
familyName |
El apellido del usuario, como se especifica en su Cuenta de Google. Ten en cuenta que este campo podría estar vacío. Requiere el permiso |
PackageEntitlement
Lista de derechos relacionados con un nombre de paquete
Representación JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Campos | |
---|---|
packageName |
Debe coincidir con el nombre del paquete en el paquete de acción |
entitlements[] |
Lista de derechos de una app determinada |
Derecho
Define los derechos digitales de un usuario. Tipos de derechos posibles: aplicaciones pagadas, compras directas desde la aplicación y suscripciones integradas en las apps.
Representación JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Campos | |
---|---|
sku |
SKU del producto Nombre del paquete de la aplicación pagada, sufijo del dócid Finsky para las compras directas desde la aplicación y la suscripción integrada en la aplicación. Haz coincidir getSku() en la API de Facturación integrada de Play. |
skuType |
|
inAppDetails |
Solo está presente para compras directas desde la aplicación y suscripciones integradas en la aplicación. |
SignedData
Representación JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Campos | |
---|---|
inAppPurchaseData |
Hacer coincidir INAPP_PURCHASE_DATA con el método getPurchases(). Contiene todos los datos de compras directas desde la aplicación en formato JSON. Consulta los detalles en la tabla 6 de https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Coincide con IN_APP_DATA_SIGNATURE con el método getPurchases() en la API de Facturación integrada en Play. |
Dispositivo
Es la información sobre el dispositivo que el usuario usa para interactuar con la acción.
Representación JSON | |
---|---|
{
"location": {
object ( |
Campos | |
---|---|
location |
Representa la ubicación real del dispositivo, como la latitud, la longitud y la dirección con formato. Requiere el permiso |
Superficie
Información específica de la plataforma cliente de Asistente de Google con la que el usuario está interactuando. Las superficies se distinguen de los dispositivos por el hecho de que pueden existir varias superficies del Asistente en el mismo dispositivo.
Representación JSON | |
---|---|
{
"capabilities": [
{
object ( |
Campos | |
---|---|
capabilities[] |
Una lista de las capacidades que la plataforma admite en el momento de la solicitud, p.ej., |
Función
Representa una unidad de funcionalidad que la superficie puede admitir.
Representación JSON | |
---|---|
{ "name": string } |
Campos | |
---|---|
name |
El nombre de la función, p.ej., |
Conversación
Representación JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Campos | |
---|---|
conversationId |
ID único para la conversación de varios turnos. Se asigna para el primer turno. Después de eso, se mantiene igual para los turnos de conversación posteriores hasta que esta finalice. |
type |
type indica el estado de la conversación en su ciclo de vida. |
conversationToken |
Token opaco especificado por la acción en el último turno de la conversación. Una acción puede usarla para hacer un seguimiento de la conversación o para almacenar datos relacionados. |
Entrada
Representación JSON | |
---|---|
{ "rawInputs": [ { object ( |
Campos | |
---|---|
rawInputs[] |
Transcripción de entrada sin procesar de cada turno de conversación. Es posible que se requiera varios turnos de conversación para que Actions on Google proporcione algunos tipos de entradas a la acción. |
intent |
Indica la intención del usuario. En el primer turno de la conversación, el intent se referirá al intent activador de la acción. Para los turnos de conversación posteriores, el intent será una acción común en el intent de Google (comienza con "acciones"). Por ejemplo, si la entrada esperada es |
arguments[] |
Una lista de valores de argumento proporcionados para la entrada que solicita la acción. |
RawInput
Representación JSON | |
---|---|
{ "inputType": enum ( |
Campos | ||
---|---|---|
inputType |
Indica cómo el usuario proporcionó esta entrada: una respuesta escrita, una respuesta de voz, sin especificar, etcétera. |
|
Campo de unión input . El valor de entrada real input puede ser solo uno de los siguientes: |
||
query |
Entrada de voz o escrita del usuario final. |
|
url |
La URL de activación. |