Method: mediaItems.batchCreate

ユーザーの Google フォト ライブラリに 1 つまたは複数のメディア アイテムを作成します。

これはメディア アイテムを作成するための 2 つ目のステップです。1 つ目のステップである未加工のバイト列を Google サーバーにアップロードする方法について詳しくは、メディアのアップロードをご覧ください。

この呼び出しを実行すると、ライブラリにメディア アイテムが追加されます。アルバムの id が指定されている場合、この呼び出しではメディア アイテムもアルバムに追加されます。各アルバムには最大 20,000 個のメディア アイテムを含めることができます。デフォルトでは、メディア アイテムはライブラリやアルバムの最後に追加されます。

アルバム id と位置の両方が定義されている場合、メディア アイテムは指定された位置でアルバムに追加されます。

呼び出しに複数のメディア アイテムが含まれている場合は、指定された位置に追加されます。オーナーではない共有アルバムにメディア アイテムを作成する場合、そのメディア アイテムを配置することはできません。そのようにすると、BAD REQUEST エラーが発生します。

HTTP リクエスト

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

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

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
フィールド
albumId

string

メディア アイテムが追加されるアルバムの識別子。メディア アイテムはユーザーのライブラリにも追加されます。このフィールドは省略できます。
newMediaItems[]

object (NewMediaItem)

必須。作成するメディア アイテムのリスト。呼び出しごとのメディア アイテムは最大 50 個です。
albumPosition

object (AlbumPosition)

メディア アイテムを追加するアルバム内の位置。指定しない場合、メディア アイテムはアルバムの最後に追加されます（デフォルト値である LAST_IN_ALBUM に従います）。このフィールドを設定しているのに albumId を指定していない場合、リクエストは失敗します。また、自分が共有アルバムのオーナーでない場合にこのフィールドを設定したときもリクエストは失敗します。

レスポンスの本文

作成されたメディア アイテムのリストです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
フィールド
newMediaItemResults[]

object (NewMediaItemResult)

出力専用。作成されたメディア アイテムのリストです。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

NewMediaItem

ユーザーの Google フォト アカウントに作成された新しいメディア アイテムです。

JSON 表現 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
フィールド
description

string

メディア アイテムの説明です。これは、Google フォト アプリのアイテムの情報に関するセクションでユーザーに表示されます。1,000 文字未満にする必要があります。ユーザーが書いたテキストのみを含めます。説明文は、文脈を追加し、ユーザーがメディアを理解できるようにする必要があります。自動生成された文字列（ファイル名、タグ、その他のメタデータなど）は含めないでください。
共用体フィールド new_media_item_type。新しいメディア アイテムの種類は、アップロード パスによって異なります。現在サポートされているアップロードでは、単純なメディア アイテムのパスのみが使用されます。new_media_item_type は次のいずれかになります。
simpleMediaItem

object (SimpleMediaItem)

付属の uploadToken を使用してアップロードされた新しいメディア アイテム。

SimpleMediaItem

アップロード トークンを使用して Google フォトで作成されるシンプルなメディア アイテムです。

JSON 表現 
{
  "uploadToken": string,
  "fileName": string
}
フィールド
uploadToken

string

Google にアップロードされたメディアのバイトを識別するトークン。
fileName

string

メディア アイテムの拡張子が付いたファイル名。この名前は Google フォトでユーザーに表示されます。このフィールドが設定されている場合、バイト アップロード プロセスで指定したファイル名は無視されます。ファイル名（ファイル拡張子を含む）は 255 文字以内にしてください。このフィールドは省略できます。

NewMediaItemResult

新しいメディア アイテムの作成結果。

JSON 表現 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
フィールド
uploadToken

string

この新しい（シンプルな）メディア アイテムの作成に使用されるアップロード トークン。メディア アイテムがシンプルで、単一のアップロード トークンを必要とする場合にのみ入力されます。
status

object (Status)

このメディア アイテムの作成中にエラーが発生した場合、このフィールドにはエラーに関連する情報が入力されます。このフィールドの詳細については、ステータスをご覧ください。
mediaItem

object (MediaItem)

アップロード トークンを使用して作成されたメディア アイテム。エラーが発生せず、メディア アイテムが正常に作成された場合に入力されます。