Compartir a través de

App Asset Service

  • Artículo

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

Se trata de un servicio de solo administrador que permite al personal de Xandr agregar imágenes relacionadas con la aplicación a Akamai. Este servicio no está disponible para los suscriptores o desarrolladores de Marketplace de aplicaciones.

API de REST

Http (método) Endpoint Description
POST https://api.appnexus.com/app-asset Agregar una imagen
GET https://api.appnexus.com/app-asset Ver todas las imágenes
GET https://api.appnexus.com/app-asset?id=ID Visualización de una imagen específica
GET https://api.appnexus.com/app-asset?plugin_id=PLUGIN_ID Visualización de todas las imágenes asociadas a una aplicación específica
DELETE https://api.appnexus.com/app-asset?id=ID Eliminación de una imagen

Campos JSON

Campo Tipo Description
id Entero Identificador único de cada imagen.
Obligatorio en: PUT y DELETE, en querystring.
plugin_id Entero Valor de id. unque del complemento al que está asociada esta imagen.
Obligatorio activado: POST
description string Texto que describe el recurso de la aplicación.
Valor predeterminado: null
category enumeración Categoría a la que pertenece el recurso de aplicación. Los valores posibles:
- "big_icon"
- "icon"
- "favicon"
- "screenshot"

Valor predeterminado: null
Obligatorio activado: POST
width Entero Ancho del recurso de aplicación, en píxeles.
Valor predeterminado: null
height Entero Alto del recurso de aplicación, en píxeles. Debe ser al menos 400.
Valor predeterminado: null
file_type enumeración Solo lectura. Tipo de imagen del recurso de la aplicación. Los valores posibles son:
- "png"
- "jpg"
- "gif".

Valor predeterminado: null
last_modified Timestamp Solo lectura. Fecha y hora en que se modificó por última vez la imagen.
media_url string Solo lectura. Dirección URL del recurso de la aplicación hospedada.
Valor predeterminado: null
content string Contenido codificado en base 64 del recurso de la aplicación. Este campo no aparece al ejecutar un GET comando.
Obligatorio activado: POST
size_in_bytes Entero Solo lectura. Tamaño del recurso de aplicación en bytes. Esto no puede superar los 2 MB.
Valor predeterminado: 0

Requisitos de imagen

  1. plugin_id debe ser válido desde el servicio del complemento.
  2. El número de recursos de aplicación para cada plugin_id no puede superar el límite especificado por allowed_asset_count en el servicio de complementos. El valor predeterminado es 5.
  3. El tamaño de la imagen no puede superar los 2 MB.
  4. El tipo de imagen debe ser .jpg, gif o .png.
  5. La imagen debe estar codificada en base 64.
  6. El alto de la imagen debe tener al menos 400 px.
  7. Las dimensiones siguientes son necesarias para estos category tipos:
    • big_icon: 150 x 175
    • icono: 96 x 96
    • favicon: 16 x 16
    • captura de pantalla: 640 x 400

Ejemplos

Agregar una imagen

$ cat add-image.json
             {
             "app-asset": {
             "id":  "3466",
             "plugin_id": "91"
             }
             }
             $ curl -b cookies -c cookies -X PUT -d @add-image.json 'https://api.appnexus.com/app-asset'
             {
             "response":{
             "status":"OK",
             "count":1,
             "id":"3467",
             "start_element":null,
             "num_elements":null,
             "app-asset":{
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             }
             }

Visualización de una imagen específica

$ curl -b cookies -c cookies 'https://api.appnexus.com/app-asset?id=3464'
             {
             "response":{
             "status":"OK",
             "count":1,
             "start_element":null,
             "num_elements":null,
             "app-asset":{
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             }
             }
             }

Ver todas las imágenes

$ curl -b cookies -c cookies 'https://api.appnexus.com/app-asset'
             {
             "response":{
             "status":"OK",
             "count":3,
             "start_element":null,
             "num_elements":null,
             "app-assets":[
             {
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             {
             "id":3468,
             "plugin_id":91,
             "description":"This is a description of the screenshot",
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             {
             "id":3469,
             "plugin_id":47,
             "description":null,
             "category":"icon",
             "width":96,
             "height":96,
             "file_type":"png",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/1b\/65\/02\/14\/1b6502147d7fa34f5a75d722fb46e4f3.png",
             "size_in_bytes":15250
             }
             ]
             }}

Visualización de todas las imágenes asociadas a una aplicación específica

$ curl -b cookies -c cookies 'http://sand.api.appnexus.com/app-asset?plugin_id=91' | json-pp
             {
             "response":{
             "status":"OK",
             "count":1,
             "start_element":null,
             "num_elements":null,
             "app-assets":[
             {
             "id":3468,
             "plugin_id":91,
             "description":"This is a description of the screenshot",
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             }
             ]
             }
             }

Eliminación de una imagen

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/app-asset?id=3468' |
             {
             "response":{
             "status":"OK",
             }
             }