Get information about a context cache

fromgoogleimport genai
fromgoogle.genai.typesimport HttpOptions
client = genai.Client(http_options=HttpOptions(api_version="v1"))
content_cache_list = client.caches.list()
# Access individual properties of a ContentCache object(s)
for content_cache in content_cache_list:
 print(f"Cache `{content_cache.name}` for model `{content_cache.model}`")
 print(f"Last updated at: {content_cache.update_time}")
 print(f"Expires at: {content_cache.expire_time}")
# Example response:
# * Cache `projects/111111111111/locations/.../cachedContents/1111111111111111111` for
# model `projects/111111111111/locations/.../publishers/google/models/gemini-XXX-pro-XXX`
# * Last updated at: 2025年02月13日 14:46:42.620490+00:00
# * CachedContentUsageMetadata(audio_duration_seconds=None, image_count=167, text_count=153, total_token_count=43130, video_duration_seconds=None)
# ...

import(
	"context"
	"fmt"
	"io"
	"net/http"
	"time"
	"google.golang.org/genai"
)
// listContentCache shows how to retrieve details about cached content.
func listContentCache(w io.Writer) error {
	ctx := context.Background()
	client, err := genai.NewClient(ctx, &genai.ClientConfig{
		HTTPOptions: genai.HTTPOptions{APIVersion: "v1"},
	})
	if err != nil {
		return fmt.Errorf("failed to create genai client: %w", err)
	}
	// Retrieve cached content metadata
	cache, err := client.Caches.List(ctx, &genai.ListCachedContentsConfig{
		HTTPOptions: &genai.HTTPOptions{
			Headers: http.Header{"X-Custom-Header": []string{"example"}},
			APIVersion: "v1",
		},
	})
	if err != nil {
		return fmt.Errorf("failed to get content cache: %w", err)
	}
	// Print basic info about the cached content
	fmt.Fprintf(w, "Cache name: %s\n", cache.Name)
	fmt.Fprintf(w, "Display name: %s\n", cache.Items[0].DisplayName)
	fmt.Fprintf(w, "Model: %s\n", cache.Items[0].Model)
	fmt.Fprintf(w, "Create time: %s\n", cache.Items[0].CreateTime.Format(time.RFC3339))
	fmt.Fprintf(w, "Update time: %s\n", cache.Items[0].UpdateTime.Format(time.RFC3339))
	fmt.Fprintf(w, "Expire time: %s (in %s)\n", cache.Items[0].ExpireTime.Format(time.RFC3339), time.Until(cache.Items[0].ExpireTime).Round(time.Second))
	if cache.Items[0].UsageMetadata != nil {
		fmt.Fprintf(w, "Usage metadata: %+v\n", cache.Items[0].UsageMetadata)
	}
	// Example response:
	// Cache name: projects/111111111111/locations/us-central1/cachedContents/1234567890123456789
	// Display name: product_recommendations_prompt
	// Model: models/gemini-2.5-flash
	// Create time: 2025-04-08T02:15:23Z
	// Update time: 2025-04-08T03:05:11Z
	// Expire time: 2025-04-20T03:05:11Z (in 167h59m59s)
	// Usage metadata: &{AudioDurationSeconds:0 ImageCount:167 TextCount:153 TotalTokenCount:43124 VideoDurationSeconds:0}
	return nil
}

importcom.google.genai.Client;
importcom.google.genai.types.CachedContent;
importcom.google.genai.types.HttpOptions;
importcom.google.genai.types.ListCachedContentsConfig;
public classContentCacheList {
 public static void main(String[] args) {
 contentCacheList();
 }
 // Lists all cached contents
 public static void contentCacheList() {
 // Initialize client that will be used to send requests. This client only needs to be created
 // once, and can be reused for multiple requests.
 try (Client client =
 Client.builder()
 .location("global")
 .vertexAI(true)
 .httpOptions(HttpOptions.builder().apiVersion("v1").build())
 .build()) {
 for (CachedContent content : client.caches.list(ListCachedContentsConfig.builder().build())) {
 content.name().ifPresent(name -> System.out.println("Name: " + name));
 content.model().ifPresent(model -> System.out.println("Model: " + model));
 content.updateTime().ifPresent(time -> System.out.println("Last updated at: " + time));
 content.expireTime().ifPresent(time -> System.out.println("Expires at: " + time));
 }
 // Example response:
 // Name: projects/111111111111/locations/global/cachedContents/1111111111111111111
 // Model:
 // projects/111111111111/locations/global/publishers/google/models/gemini-2.5-flash
 // Last updated at: 2025-07-28T21:54:19.125825Z
 // Expires at: 2025-08-04T21:54:18.328233500Z
 // ...
 }
 }
}

const{GoogleGenAI}=require('@google/genai');
constGOOGLE_CLOUD_PROJECT=process.env.GOOGLE_CLOUD_PROJECT;
constGOOGLE_CLOUD_LOCATION=process.env.GOOGLE_CLOUD_LOCATION||'global';
asyncfunctionlistContentCaches(
projectId=GOOGLE_CLOUD_PROJECT,
location=GOOGLE_CLOUD_LOCATION
){
constclient=newGoogleGenAI({
vertexai:true,
project:projectId,
location:location,
httpOptions:{
apiVersion:'v1',
},
});
constcontentCacheList=awaitclient.caches.list();
//AccessindividualpropertiesofaContentCacheobject(s)
constcontentCacheNames=[];
for(constcontentCacheofcontentCacheList.pageInternal){
console.log(
`Cache\`${contentCache.name}\`formodel\`${contentCache.model}\``
);
console.log(`Lastupdatedat:${contentCache.updateTime}`);
console.log(`Expiresat:${contentCache.expireTime}`);
contentCacheNames.push(contentCache.name);
}
console.log(contentCacheNames);
//Exampleresponse:
//*Cache`projects/111111111111/locations/us-central1/cachedContents/1111111111111111111`for
//model`projects/111111111111/locations/us-central1/publishers/google/models/gemini-XXX-pro-XXX`
//*Lastupdatedat:2025-02-1314:46:42.620490+00:00
//*CachedContentUsageMetadata(audio_duration_seconds=None,image_count=167,text_count=153,total_token_count=43130,video_duration_seconds=None)
//...
returncontentCacheNames;
}