Skip to main content
En konto installerer en app én gang, uanset hvor mange experiences den tilføjer, så en installation indeholder tilstand, der tilhører kontoen frem for én experience, såsom en synkroniseringsmarkør eller ID’et på den konto, den er knyttet til i et andet system. Brug App Installations API’et til at vise de konti, din app er installeret på, hente en enkelt og opdatere de metadata og external_id, som din app gemmer på den. En konto kan også vise de apps, der er installeret på den, og en udvikler alle installationer af sin app. Kun appen og dens udvikler kan se metadata og external_id, og kun appen kan ændre dem.

Endpoints

Attributter

string
påkrævet
App installation-ID med præfikset aag_.
object
påkrævet
Kontoen, som appen er installeret på.

Egenskaber

string
påkrævet
Konto-ID med præfikset biz_.
string
påkrævet
Kontoens visningsnavn.
object
påkrævet
Den installerede app.

Egenskaber

string
påkrævet
App-ID med præfikset app_.
object
påkrævet
Kontoen, der udvikler appen.

Egenskaber

string
påkrævet
Konto-ID med præfikset biz_.
string
påkrævet
Kontoens visningsnavn.
object
påkrævet
App-ikon. Falder tilbage til standard-app-ikonet, når der ikke er uploadet et.

Egenskaber

string
påkrævet
URL til ikonbilledet. Altid til stede — standard-app-ikonet, når der ikke er uploadet et.
string
påkrævet
Appens visningsnavn.
string
påkrævet
Hvornår appen første gang blev installeret på kontoen, som et ISO 8601-tidsstempel. Hvis appen installeres igen senere, bevares det oprindelige tidspunkt.
string | null
påkrævet
Din apps egen identifikator for denne installation, såsom ID’et på den tilknyttede konto i et andet system, eller null, når ingen er angivet. Højst 255 tegn og unik på tværs af din apps installationer, så du kan finde en installation med GET /app_installations?external_id=; hvis du angiver en, som en anden installation allerede har, returneres en 409. Kun appen og dens udvikler kan se den; for den konto, appen er installeret på, er den altid null.
object | null
påkrævet
Strengnøgler og -værdier, som din app gemmer om denne installation, såsom en synkroniserings- markør eller ID’et på den tilknyttede konto i et andet system. Tom, indtil din app angiver en nøgle, og bevares, hvis kontoen fjerner appen og installerer den igen. Højst 50 nøgler; nøgler er højst 100 tegn og værdier højst 500. Kun appen kan ændre den. Kun appen og dens udvikler kan se den; for den konto, appen er installeret på, er den altid null.
boolean
påkrævet
Om appen nu beder om tilladelser, som kontoen endnu ikke har godkendt.
string
påkrævet
Hvornår installationen sidst blev ændret, såsom en metadata-opdatering eller at kontoen ændrede appens tilladelser, som et ISO 8601-tidsstempel.
AppInstallation