Method: albums.addEnrichment

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
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。