google-genai/com.google.genai.types/CachedContent

CachedContent

public abstract class CachedContent extends JsonSerializable

A resource used in LLM queries for users to explicitly specify what to cache.

Constructors

Link copied to clipboard
public void CachedContent()

Types

Link copied to clipboard
public abstract class Builder
Builder for CachedContent.

Properties

Link copied to clipboard
public final static String MAX_READ_LENGTH_PROPERTY
System property to override the default max JSON string length (20MB) in read constraints.

Functions

Link copied to clipboard
public static CachedContent.Builder builder()
Instantiates a builder for CachedContent.
Link copied to clipboard
public abstract Optional<Instant> createTime()
Creation time of the cache entry.
Link copied to clipboard
public abstract Optional<String> displayName()
The user-generated meaningful display name of the cached content.
Link copied to clipboard
public abstract Optional<Instant> expireTime()
Expiration time of the cached content.
Link copied to clipboard
public static CachedContent fromJson(String jsonString)
Deserializes a JSON string to a CachedContent object.
Link copied to clipboard
@InternalApi()
public static T fromJsonNode<T extends JsonSerializable>(JsonNode jsonNode, Class<T> clazz)
Deserializes a JsonNode to an object of the given type.
Link copied to clipboard
@InternalApi()
public static T fromJsonString<T extends JsonSerializable>(String jsonString, Class<T> clazz)
Deserializes a Json string to an object of the given type.
Link copied to clipboard
public abstract Optional<String> model()
The name of the publisher model to use for cached content.
Link copied to clipboard
public abstract Optional<String> name()
The server-generated resource name of the cached content.
Link copied to clipboard
public static ObjectMapper objectMapper()
Link copied to clipboard
public static void setMaxReadLength(int maxReadLength)
Overrides the default maximum JSON string length (20MB) for the JSON parser.
Link copied to clipboard
public static JsonNode stringToJsonNode(String string)
Converts a Json string to a JsonNode.
Link copied to clipboard
public abstract CachedContent.Builder toBuilder()
Creates a builder with the same values as this instance.
Link copied to clipboard
public String toJson()
Serializes the instance to a Json string.
Link copied to clipboard
public static JsonNode toJsonNode(Object object)
Serializes an object to a JsonNode.
Link copied to clipboard
public static String toJsonString(Object object)
Serializes an object to a Json string.
Link copied to clipboard
public abstract Optional<Instant> updateTime()
When the cache entry was last updated in UTC time.
Link copied to clipboard
public abstract Optional<CachedContentUsageMetadata> usageMetadata()
Metadata on the usage of the cached content.