Method: albums.addEnrichment

定義されたアルバムの指定された位置にエンリッチメントを追加します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

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。