Method: albums.addEnrichment

Dodaje wzbogacenie w określonym miejscu w albumie utworzonym w aplikacji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
albumId

string

Wymagane. Identyfikator albumu utworzonego przez aplikację, do którego chcesz dodać wzbogacenie.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Pola
newEnrichmentItem

object (NewEnrichmentItem)

Wymagane. Wzbogacenie, które ma zostać dodane.

albumPosition

object (AlbumPosition)

Wymagane. Pozycja w albumie utworzonym w aplikacji, w której ma zostać wstawione wzbogacenie.

Treść odpowiedzi

Utworzony element wzbogacenia.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Pola
enrichmentItem

object (EnrichmentItem)

Tylko dane wyjściowe. Wzbogacenie, które zostało dodane.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

NewEnrichmentItem

Nowy element wzbogacenia, który ma zostać dodany do albumu utworzonego przez aplikację i używany przez wywołanie albums.addEnrichment.

Zapis 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.
}
Pola
Pole unii enrichment. Wzbogacenie, które ma zostać dodane do albumu utworzonego przez aplikację. Może to być tekst, lokalizacja lub mapa. enrichment może być tylko jednym z tych elementów:
textEnrichment

object (TextEnrichment)

Tekst, który ma zostać dodany do albumu utworzonego przez aplikację.

locationEnrichment

object (LocationEnrichment)

Lokalizacja, która ma zostać dodana do albumu utworzonego przez aplikację.

mapEnrichment

object (MapEnrichment)

Mapa, która ma zostać dodana do albumu utworzonego przez aplikację.

TextEnrichment

wzbogacenie zawierające tekst.

Zapis JSON
{
  "text": string
}
Pola
text

string

Tekst dotyczący tego elementu wzbogacenia.

LocationEnrichment

Wzbogacenie zawierające jedną lokalizację.

Zapis JSON
{
  "location": {
    object (Location)
  }
}
Pola
location

object (Location)

Lokalizacja tego elementu wzbogacenia.

Lokalizacja

Reprezentuje lokalizację fizyczną.

Zapis JSON
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Pola
locationName

string

Nazwa wyświetlanej lokalizacji.

latlng

object (LatLng)

Pozycja lokalizacji na mapie.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb podwójnie po przecinku, która reprezentuje stopnie szerokości i długości geograficznej. Jeśli nie określono inaczej, obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w normalizowanych zakresach.

Zapis JSON
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].

longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0, +180,0].

MapEnrichment

wzbogacenie zawierające mapę z miejscem wyjazdu i miejscem docelowym;

Zapis JSON
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Pola
origin

object (Location)

Miejsce pochodzenia tego elementu wzbogacenia.

destination

object (Location)

Miejsce docelowe dla tego elementu wzbogacenia.

EnrichmentItem

Element wzbogacenia.

Zapis JSON
{
  "id": string
}
Pola
id

string

Identyfikator elementu wzbogacenia.