REST Resource: cachedContents

{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "usageMetadata": {
    object (UsageMetadata)
  },

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
  "name": string,
  "displayName": string,
  "model": string,
  "systemInstruction": {
    object (Content)
  },
  "toolConfig": {
    object (ToolConfig)
  }
}

object (Content)

省略可。入力のみの変更不可。キャッシュに保存するコンテンツ。

object (Tool)

省略可。入力のみの変更不可。モデルが次のレスポンスを生成するために使用できる Tools のリスト

string (Timestamp format)

出力専用。キャッシュ エントリの作成時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

出力専用。キャッシュ エントリが最後に更新された日時（UTC 時間）。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

object (UsageMetadata)

出力専用。キャッシュに保存されたコンテンツの使用に関するメタデータ。

string (Timestamp format)

このリソースが期限切れとみなされるタイムスタンプ（UTC）。入力の送信内容に関係なく、出力には常に指定されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

string (Duration format)

入力のみのこのリソースの新しい TTL（入力のみ）。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

string

省略可。ID。キャッシュに保存されたコンテンツを参照するリソース名。形式: cachedContents/{id}

string

省略可。変更不可。キャッシュに保存されたコンテンツの、ユーザー生成のわかりやすい表示名。最大 128 文字（Unicode 文字）。

string

必須。変更不可。キャッシュに保存されたコンテンツ形式に使用する Model の名前: models/{model}

object (Content)

省略可。入力のみの変更不可。デベロッパーが設定するシステム指示。現在はテキストのみです。

object (ToolConfig)

省略可。入力のみの変更不可。ツール構成。この構成はすべてのツールで共有されます。

{
  "parts": [
    {
      object (Part)
    }
  ],
  "role": string
}

object (Part)

順序付けされた Parts で、単一のメッセージを構成します。パーツによって MIME タイプが異なる場合があります。

string

省略可。コンテンツの制作者。「user」または「model」のいずれかを指定します。

マルチターンの会話を設定する場合に便利です。それ以外の場合は、空白または未設定のままにできます。

{

  // Union field data can be only one of the following:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "functionCall": {
    object (FunctionCall)
  },
  "functionResponse": {
    object (FunctionResponse)
  },
  "fileData": {
    object (FileData)
  }
  // End of list of possible types for union field data.
}

string

インライン テキスト。

object (Blob)

インライン メディア バイト。

object (FunctionCall)

モデルから返された予測された FunctionCall。引数とその値を含む FunctionDeclaration.name を表す文字列を含みます。

object (FunctionResponse)

FunctionDeclaration.name を表す文字列と、関数からの出力を含む構造化 JSON オブジェクトを含む FunctionCall の結果出力が、モデルのコンテキストとして使用されます。

object (FileData)

URI ベースのデータ。

{
  "mimeType": string,
  "data": string
}

string

ソースデータの IANA 標準 MIME タイプ。例: - image/png - image/jpeg サポートされていない MIME タイプを指定すると、エラーが返されます。サポートされている種類の一覧については、サポートされているファイル形式をご覧ください。

string (bytes format)

メディア形式の未加工のバイトです。

Base64 でエンコードされた文字列。

{
  "name": string,
  "args": {
    object
  }
}

string

必須。呼び出す関数の名前。a ～ z、A ～ Z、0 ～ 9 にする必要があり、アンダースコアとダッシュを含めることができます。最大長は 63 です。

object (Struct format)

省略可。JSON オブジェクト形式の関数パラメータと値。

{
  "name": string,
  "response": {
    object
  }
}

string

必須。呼び出す関数の名前。a ～ z、A ～ Z、0 ～ 9 にする必要があり、アンダースコアとダッシュを含めることができます。最大長は 63 です。

object (Struct format)

必須。JSON オブジェクト形式の関数のレスポンス。

{
  "mimeType": string,
  "fileUri": string
}

string

省略可。ソースデータの IANA 標準 MIME タイプ。

string

必須。URI です。

{
  "functionDeclarations": [
    {
      object (FunctionDeclaration)
    }
  ]
}

object (FunctionDeclaration)

省略可。モデルで使用可能な FunctionDeclarations のリスト。関数の呼び出しに使用できます。

モデルまたはシステムが関数を実行しません。代わりに、定義された関数は、実行のためにクライアント側への引数を含む [FunctionCall][content.part.function_call] として返される場合があります。モデルは、レスポンスに [FunctionCall][content.part.function_call] を入力することで、これらの関数のサブセットを呼び出すことができます。次の会話ターンには、次のモデルターンのための [content.role]「function」生成コンテキストを持つ [FunctionResponse][content.part.function_response] が含まれる場合があります。

{
  "name": string,
  "description": string,
  "parameters": {
    object (Schema)
  }
}

string

必須。関数の名前。a ～ z、A ～ Z、0 ～ 9 にする必要があり、アンダースコアとダッシュを含めることができます。最大長は 63 です。

string

必須。関数の簡単な説明。

object (Schema)

省略可。この関数のパラメータを記述します。Open API 3.03 パラメータ オブジェクト文字列を反映します。キー: パラメータの名前。パラメータ名では大文字と小文字が区別されます。Schema Value: パラメータに使用される型を定義するスキーマ。

{
  "type": enum (Type),
  "format": string,
  "description": string,
  "nullable": boolean,
  "enum": [
    string
  ],
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "items": {
    object (Schema)
  }
}

enum (Type)

必須。データ型。

string

省略可。データの形式。これはプリミティブ データ型にのみ使用されます。サポートされている形式: NUMBER 型の場合: float、INTEGER 型の場合 double: int32、int64

string

省略可。パラメータの簡単な説明。これには使用例が含まれる場合があります。パラメータの説明はマークダウンの形式にできます。

boolean

省略可。値が null の可能性があるかどうかを示します。

string

省略可。Type.STRING の要素に可能な値（列挙型形式）。たとえば、列挙型の方向は {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} として定義できます。

map (key: string, value: object (Schema))

省略可。Type.OBJECT のプロパティ。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }。

string

省略可。Type.OBJECT の必須プロパティ。

object (Schema)

省略可。Type.ARRAY の要素のスキーマ。

{
  "functionCallingConfig": {
    object (FunctionCallingConfig)
  }
}

object (FunctionCallingConfig)

省略可。関数呼び出しの構成。

{
  "mode": enum (Mode),
  "allowedFunctionNames": [
    string
  ]
}

enum (Mode)

省略可。関数呼び出しを実行するモードを指定します。指定しない場合、デフォルト値が AUTO に設定されます。

string

省略可。指定すると、モデルが呼び出す関数を制限する関数名のセット。

Mode が ANY の場合にのみ設定する必要があります。関数名は [FunctionDeclaration.name] と一致する必要があります。モードを ANY に設定すると、モデルは指定された関数名のセットから関数呼び出しを予測します。

{
  "totalTokenCount": integer
}

integer

キャッシュに保存されたコンテンツが消費するトークンの合計数。