Method: albums.addEnrichment

在已定義相簿的特定位置新增充實內容。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
albumId

string

必要欄位。要新增擴充內容的相簿 ID。

要求主體

要求主體的資料會採用以下結構:

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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

將新的擴充項目新增至相簿,供 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)

要新增至相簿的地圖。

TextEnrichment

包含文字的擴充資料。

JSON 表示法
{
  "text": string
}
欄位
text

string

這個擴充項目的文字。

LocationEnrichment

包含單一位置的擴充資料。

JSON 表示法
{
  "location": {
    object (Location)
  }
}
欄位
location

object (Location)

這個擴充項目的位置。

位置

代表實際地點。

JSON 表示法
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
欄位
locationName

string

要顯示的地點名稱。

latlng

object (LatLng)

地圖上的位置位置。

LatLng

代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。

JSON 表示法
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。

longitude

number

經度度數,必須介於 [-180.0, +180.0] 的範圍之間。

MapEnrichment

包含地圖的補充資訊,顯示出發地和目的地位置。

JSON 表示法
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
欄位
origin

object (Location)

這個內容強化項目的原始位置。

destination

object (Location)

這個豐富多樣商品的目的地位置。

EnrichmentItem

擴充項目。

JSON 表示法
{
  "id": string
}
欄位
id

string

擴充項目的 ID。