Skip to main content
Una cuenta instala una app una sola vez, sin importar cuántas experiencias añada, por lo que una instalación guarda el estado que pertenece a la cuenta y no a una experiencia concreta, como un cursor de sincronización o el ID de la cuenta con la que está vinculada en otro sistema. Usa la API de App Installations para listar las cuentas en las que está instalada tu app, obtener una y actualizar los campos metadata y external_id que tu app guarda en ella. Una cuenta también puede listar las apps instaladas en ella, y un desarrollador todas las instalaciones de su app. Solo la app y su desarrollador ven metadata y external_id, y solo la app puede cambiarlos.

Endpoints

Atributos

string
requerido
ID de la instalación de la app, con el prefijo aag_.
object
requerido
Cuenta en la que está instalada la app.

Propiedades

string
requerido
ID de la cuenta, con el prefijo biz_.
string
requerido
Nombre visible de la cuenta.
object
requerido
App que está instalada.

Propiedades

string
requerido
ID de la app, con el prefijo app_.
object
requerido
Cuenta que desarrolla la app.

Propiedades

string
requerido
ID de la cuenta, con el prefijo biz_.
string
requerido
Nombre visible de la cuenta.
object
requerido
Icono de la app. Usa el icono predeterminado de la app cuando no se ha subido ninguno.

Propiedades

string
requerido
URL de la imagen del icono. Siempre presente: es el icono predeterminado de la app cuando no se ha subido ninguno.
string
requerido
Nombre visible de la app.
string
requerido
Cuándo se instaló la app por primera vez en la cuenta, como marca de tiempo ISO 8601. Volver a instalar la app más tarde conserva la hora original.
string | null
requerido
El identificador propio de tu app para esta instalación, como el ID de la cuenta vinculada en otro sistema, o null cuando no se ha establecido ninguno. Como máximo 255 caracteres y único entre las instalaciones de tu app, para que puedas encontrar una instalación con GET /app_installations?external_id=; establecer uno que ya tiene otra instalación devuelve un 409. Solo la app y su desarrollador lo ven; para la cuenta en la que está instalada la app siempre es null.
object | null
requerido
Claves y valores de tipo string que tu app almacena sobre esta instalación, como un cursor de sincronización o el ID de la cuenta vinculada en otro sistema. Vacío hasta que tu app establece una clave, y se conserva si la cuenta elimina la app y la vuelve a instalar. Como máximo 50 claves; las claves tienen como máximo 100 caracteres y los valores como máximo 500. Solo la app puede cambiarlo. Solo la app y su desarrollador lo ven; para la cuenta en la que está instalada la app siempre es null.
boolean
requerido
Si la app ahora solicita permisos que la cuenta aún no ha aprobado.
string
requerido
Cuándo cambió la instalación por última vez, como una actualización de metadata o un cambio de los permisos de la app por parte de la cuenta, como marca de tiempo ISO 8601.
AppInstallation