Method: albums.addEnrichment

Adiciona um enriquecimento em uma posição especificada em um álbum definido.

Solicitação HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
albumId

string

Obrigatório. Identificador do álbum em que o aprimoramento será adicionado.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Campos
newEnrichmentItem

object (NewEnrichmentItem)

Obrigatório. O enriquecimento a ser adicionado.

albumPosition

object (AlbumPosition)

Obrigatório. A posição no álbum em que o aprimoramento será inserido.

Corpo da resposta

O item de aprimoramento que é criado.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Campos
enrichmentItem

object (EnrichmentItem)

Apenas saída. Enriquecimento adicionado.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

Um novo item de aprimoramento a ser adicionado a um álbum, usado pela chamada albums.addEnrichment.

Representação JSON
{

  // Union field enrichment can be only one of the following:
  "textEnrichment": {
    object (TextEnrichment)
  },
  "locationEnrichment": {
    object (LocationEnrichment)
  },
  "mapEnrichment": {
    object (MapEnrichment)
  }
  // End of list of possible types for union field enrichment.
}
Campos
Campo de união enrichment. Aprimoramento a ser adicionado ao álbum. Pode ser um texto, um local ou um mapa. enrichment pode ser apenas de um dos tipos a seguir:
textEnrichment

object (TextEnrichment)

Texto a ser adicionado ao álbum.

locationEnrichment

object (LocationEnrichment)

Local a ser adicionado ao álbum.

mapEnrichment

object (MapEnrichment)

Mapa a ser adicionado ao álbum.

TextEnrichment

Um enriquecimento contendo texto.

Representação JSON
{
  "text": string
}
Campos
text

string

Texto para este item de aprimoramento.

LocationEnrichment

Um aprimoramento contendo um único local.

Representação JSON
{
  "location": {
    object (Location)
  }
}
Campos
location

object (Location)

Local deste item de aprimoramento.

Local

Representa um local físico.

Representação JSON
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Campos
locationName

string

Nome do local a ser exibido.

latlng

object (LatLng)

Posição do local no mapa.

LatLng

Um objeto que representa um par de latitude/longitude. Ele é expresso como um par de valores duplos para representar graus de latitude e longitude. Salvo indicação em contrário, esse objeto precisa estar em conformidade com o padrão WGS84. Os valores precisam estar dentro de intervalos normalizados.

Representação JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].

longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

MapEnrichment

Um aprimoramento contendo um mapa, mostrando locais de origem e destino.

Representação JSON
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Campos
origin

object (Location)

Local de origem deste item de enriquecimento.

destination

object (Location)

Local de destino para este item avançado.

EnrichmentItem

Um item de aprimoramento.

Representação JSON
{
  "id": string
}
Campos
id

string

Identificador do item de enriquecimento.