Method: albums.addEnrichment

Thêm phần bổ sung ở một vị trí đã chỉ định trong album xác định.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
albumId

string

Bắt buộc. Giá trị nhận dạng của album cần thêm tính năng phong phú.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
Trường
newEnrichmentItem

object (NewEnrichmentItem)

Bắt buộc. Tính bổ sung cần được bổ sung.
albumPosition

object (AlbumPosition)

Bắt buộc. Vị trí trong album mà bổ sung sẽ được chèn vào.

Nội dung phản hồi

Mục bổ ích đã được tạo.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
Trường
enrichmentItem

object (EnrichmentItem)

Chỉ có đầu ra. Đã thêm tính năng bổ sung.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

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

NewEnrichmentItem

Một mục bổ ích mới sẽ được thêm vào album, được lệnh gọi albums.addEnrichment sử dụng.

Biểu diễn dưới dạng 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.
}
Trường
Trường hợp enrichment. Nội dung bổ ích sẽ được thêm vào album. Đây có thể là văn bản, vị trí hoặc bản đồ. enrichment chỉ có thể là một trong những trạng thái sau:
textEnrichment

object (TextEnrichment)

Văn bản sẽ được thêm vào album.
locationEnrichment

object (LocationEnrichment)

Vị trí sẽ được thêm vào album.
mapEnrichment

object (MapEnrichment)

Bản đồ sẽ được thêm vào album.

TextEnrichment

Nội dung bổ ích có chứa văn bản.

Biểu diễn dưới dạng JSON 
{
  "text": string
}
Trường
text

string

Văn bản của mục bổ sung này.

LocationEnrichment

Một thành phần bổ ích có chứa một vị trí duy nhất.

Biểu diễn dưới dạng JSON 
{
  "location": {
    object (Location)
  }
}
Trường
location

object (Location)

Vị trí của mục bổ sung này.

Vị trí

Đại diện cho một vị trí thực tế.

Biểu diễn dưới dạng JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
Trường
locationName

string

Tên của vị trí sẽ hiển thị.
latlng

object (LatLng)

Vị trí của vị trí trên bản đồ.

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Thuộc tính này được biểu thị dưới dạng một cặp đôi đại diện cho độ vĩ độ và kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi đã chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính theo độ. Giá trị phải nằm trong phạm vi [-90.0, +90.0].
longitude

number

Kinh độ tính theo độ. Giá trị phải nằm trong phạm vi [-180.0, +180.0].

MapEnrichment

Một kết quả bổ sung có chứa bản đồ, cho thấy vị trí điểm khởi hành và vị trí điểm đến.

Biểu diễn dưới dạng JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
Trường
origin

object (Location)

Vị trí gốc của vật phẩm bổ sung này.
destination

object (Location)

Vị trí điểm đến của mục bổ sung chi tiết này.

EnrichmentItem

Một vật phẩm bổ ích.

Biểu diễn dưới dạng JSON 
{
  "id": string
}
Trường
id

string

Giá trị nhận dạng của mục bổ sung.