Method: albums.addEnrichment

Thêm nội dung làm phong phú ở một vị trí đã chỉ định trong album do ứng dụng tạo.

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

Thông số
albumId

string

Bắt buộc. Giá trị nhận dạng của album do ứng dụng tạo ra, nơi bạn sẽ thêm nội dung làm 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. Nội dung làm phong phú cần thêm.
albumPosition

object (AlbumPosition)

Bắt buộc. Vị trí trong album do ứng dụng tạo ra để chèn nội dung làm phong phú.

Nội dung phản hồi

Mục làm phong phú đượ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. Nội dung làm phong phú đã được thêm.

Phạm vi uỷ quyền

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

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

NewEnrichmentItem

Một mục làm phong phú mới sẽ được thêm vào album do ứng dụng tạo, đượ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 hợp nhất enrichment. Nội dung làm phong phú sẽ được thêm vào album do ứng dụng tạo. Đây có thể là văn bản, vị trí hoặc bản đồ. enrichment chỉ có thể là một trong những loại sau:
textEnrichment

object (TextEnrichment)

Văn bản sẽ được thêm vào album do ứng dụng tạo.
locationEnrichment

object (LocationEnrichment)

Vị trí sẽ được thêm vào album do ứng dụng tạo.
mapEnrichment

object (MapEnrichment)

Bản đồ sẽ được thêm vào album do ứng dụng tạo.

TextEnrichment

Nội dung làm phong phú 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 cho mục làm phong phú này.

LocationEnrichment

Nội dung làm phong phú chứa một vị trí.

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

object (Location)

Vị trí của mục làm phong phú này.

Vị trí

Biểu thị 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 địa điểm sẽ xuất hiện.
latlng

object (LatLng)

Vị trí của địa điểm trên bản đồ.

LatLng

Một đối tượng đại diện cho một cặp vĩ độ/kinh độ. Giá trị này được biểu thị dưới dạng một cặp số thực để thể hiện vĩ độ và kinh độ theo độ. 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 bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

MapEnrichment

Nội dung làm phong phú chứa bản đồ, cho thấy vị trí xuất phát và vị trí đế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 mục làm phong phú này.
destination

object (Location)

Vị trí đích đến của mục làm phong phú này.

EnrichmentItem

Một mục làm phong phú.

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 làm phong phú.