Compute the head cursor for the partition.
The head cursor's offset is guaranteed to be less than or equal to all
messages which have not yet been acknowledged as published, and
greater than the offset of any message whose publish has already
been acknowledged. It is zero if there have never been messages in the
partition.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Interface TopicStatsServiceGrpc.AsyncService (1.15.13)\n\nVersion latestkeyboard_arrow_down\n\n- [1.15.13 (latest)](/java/docs/reference/google-cloud-pubsublite/latest/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.15.12](/java/docs/reference/google-cloud-pubsublite/1.15.12/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.14.8](/java/docs/reference/google-cloud-pubsublite/1.14.8/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.13.8](/java/docs/reference/google-cloud-pubsublite/1.13.8/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.12.22](/java/docs/reference/google-cloud-pubsublite/1.12.22/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.11.2](/java/docs/reference/google-cloud-pubsublite/1.11.2/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.10.0](/java/docs/reference/google-cloud-pubsublite/1.10.0/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.9.4](/java/docs/reference/google-cloud-pubsublite/1.9.4/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.8.0](/java/docs/reference/google-cloud-pubsublite/1.8.0/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.7.1](/java/docs/reference/google-cloud-pubsublite/1.7.1/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.6.3](/java/docs/reference/google-cloud-pubsublite/1.6.3/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.5.5](/java/docs/reference/google-cloud-pubsublite/1.5.5/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService)\n- [1.4.12](/java/docs/reference/google-cloud-pubsublite/1.4.12/com.google.cloud.pubsublite.proto.TopicStatsServiceGrpc.AsyncService) \n\n public static interface TopicStatsServiceGrpc.AsyncService\n\nThis service allows users to get stats about messages in their topic.\n\nMethods\n-------\n\n### computeHeadCursor(ComputeHeadCursorRequest request, StreamObserver\\\u003cComputeHeadCursorResponse\\\u003e responseObserver)\n\n public default void computeHeadCursor(ComputeHeadCursorRequest request, StreamObserver\u003cComputeHeadCursorResponse\u003e responseObserver)\n\nCompute the head cursor for the partition.\nThe head cursor's offset is guaranteed to be less than or equal to all\nmessages which have not yet been acknowledged as published, and\ngreater than the offset of any message whose publish has already\nbeen acknowledged. It is zero if there have never been messages in the\npartition.\n\n### computeMessageStats(ComputeMessageStatsRequest request, StreamObserver\\\u003cComputeMessageStatsResponse\\\u003e responseObserver)\n\n public default void computeMessageStats(ComputeMessageStatsRequest request, StreamObserver\u003cComputeMessageStatsResponse\u003e responseObserver)\n\nCompute statistics about a range of messages in a given topic and\npartition.\n\n### computeTimeCursor(ComputeTimeCursorRequest request, StreamObserver\\\u003cComputeTimeCursorResponse\\\u003e responseObserver)\n\n public default void computeTimeCursor(ComputeTimeCursorRequest request, StreamObserver\u003cComputeTimeCursorResponse\u003e responseObserver)\n\nCompute the corresponding cursor for a publish or event time in a topic\npartition."]]
