Method: albums.addEnrichment

Добавляет дополнение в указанную позицию в созданном приложением альбоме.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
albumId

string

Необходимый. Идентификатор созданного приложением альбома, в который необходимо добавить дополнение.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Поля
newEnrichmentItem

object ( NewEnrichmentItem )

Необходимый. Обогащение, которое необходимо добавить.

albumPosition

object ( AlbumPosition )

Необходимый. Позиция в альбоме, созданном приложением, куда необходимо вставить дополнение.

Тело ответа

Созданный элемент обогащения.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Поля
enrichmentItem

object ( EnrichmentItem )

Только вывод. Дополнение, которое было добавлено.

Области авторизации

Требуется одна из следующих областей OAuth:

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

Новый элемент обогащения

Новый элемент дополнения, добавляемый в альбом, созданный приложением, используемый вызовом albums.addEnrichment .

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.
}
Поля
enrichment полей Союза. Дополнение будет добавлено в альбом, созданный приложением. Это может быть текст, местоположение или карта. enrichment может быть только одним из следующих:
textEnrichment

object ( TextEnrichment )

Текст, который будет добавлен в альбом, созданный приложением.

locationEnrichment

object ( LocationEnrichment )

Место для добавления в альбом, созданный приложением.

mapEnrichment

object ( MapEnrichment )

Карта будет добавлена ​​в альбом, созданный приложением.

Обогащение текста

Дополнение, содержащее текст.

JSON-представление 
{
  "text": string
}
Поля
text

string

Текст для этого дополнительного элемента.

МестоположениеОбогащение

Дополнение, содержащее одну локацию.

JSON-представление 
{
  "location": {
    object (Location)
  }
}
Поля
location

object ( Location )

Местоположение этого предмета обогащения.

Расположение

Представляет физическое местоположение.

JSON-представление 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Поля
locationName

string

Название места, которое будет отображаться.

latlng

object ( LatLng )

Положение места на карте.

ШиротаДлительность

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0].

Обогащение карты

Дополнение, содержащее карту с указанием пунктов отправления и назначения.

JSON-представление 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Поля
origin

object ( Location )

Место происхождения этого предмета обогащения.

destination

object ( Location )

Место назначения для этого обогащенного предмета.

Элемент обогащения

Предмет обогащения.

JSON-представление 
{
  "id": string
}
Поля
id

string

Идентификатор предмета обогащения.

,

Добавляет дополнение в указанную позицию в созданном приложением альбоме.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
albumId

string

Необходимый. Идентификатор созданного приложением альбома, в который необходимо добавить дополнение.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Поля
newEnrichmentItem

object ( NewEnrichmentItem )

Необходимый. Обогащение, которое необходимо добавить.

albumPosition

object ( AlbumPosition )

Необходимый. Позиция в альбоме, созданном приложением, куда необходимо вставить дополнение.

Тело ответа

Созданный элемент обогащения.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Поля
enrichmentItem

object ( EnrichmentItem )

Только вывод. Дополнение, которое было добавлено.

Области авторизации

Требуется одна из следующих областей OAuth:

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

Новый элемент обогащения

Новый элемент дополнения, добавляемый в альбом, созданный приложением, используемый вызовом albums.addEnrichment .

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.
}
Поля
enrichment полей Союза. Дополнение будет добавлено в альбом, созданный приложением. Это может быть текст, местоположение или карта. enrichment может быть только одним из следующих:
textEnrichment

object ( TextEnrichment )

Текст, который будет добавлен в альбом, созданный приложением.

locationEnrichment

object ( LocationEnrichment )

Место для добавления в альбом, созданный приложением.

mapEnrichment

object ( MapEnrichment )

Карта будет добавлена ​​в альбом, созданный приложением.

Обогащение текста

Дополнение, содержащее текст.

JSON-представление 
{
  "text": string
}
Поля
text

string

Текст для этого дополнительного элемента.

МестоположениеОбогащение

Дополнение, содержащее одну локацию.

JSON-представление 
{
  "location": {
    object (Location)
  }
}
Поля
location

object ( Location )

Местоположение этого предмета обогащения.

Расположение

Представляет физическое местоположение.

JSON-представление 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Поля
locationName

string

Название места, которое будет отображаться.

latlng

object ( LatLng )

Положение места на карте.

ШиротаДлительность

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0].

Обогащение карты

Дополнение, содержащее карту с указанием пунктов отправления и назначения.

JSON-представление 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Поля
origin

object ( Location )

Место происхождения этого предмета обогащения.

destination

object ( Location )

Место назначения для этого обогащенного предмета.

Элемент обогащения

Предмет обогащения.

JSON-представление 
{
  "id": string
}
Поля
id

string

Идентификатор предмета обогащения.