pubsublite

package
v0.193.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 20, 2024 License: BSD-3-Clause Imports: 16 Imported by: 0

Documentation

Overview

Package pubsublite provides access to the Pub/Sub Lite API.

For product documentation, see: https://cloud.google.com/pubsub/lite/docs

Library status

These client libraries are officially supported by Google. However, this library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.

When possible, we recommend using our newer [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) that are still actively being worked and iterated on.

Creating a client

Usage example:

import "google.golang.org/api/pubsublite/v1"
...
ctx := context.Background()
pubsubliteService, err := pubsublite.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication. For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support API keys), use google.golang.org/api/option.WithAPIKey:

pubsubliteService, err := pubsublite.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow, use google.golang.org/api/option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
pubsubliteService, err := pubsublite.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See google.golang.org/api/option.ClientOption for details on options.

Index

Constants

View Source
const (
	// See, edit, configure, and delete your Google Cloud data and see the email
	// address for your Google Account.
	CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type AdminProjectsLocationsOperationsCancelCall added in v0.53.0

type AdminProjectsLocationsOperationsCancelCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsOperationsCancelCall) Context added in v0.53.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsOperationsCancelCall) Do added in v0.53.0

Do executes the "pubsublite.admin.projects.locations.operations.cancel" call. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsOperationsCancelCall) Fields added in v0.53.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsOperationsCancelCall) Header added in v0.53.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsOperationsDeleteCall added in v0.53.0

type AdminProjectsLocationsOperationsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsOperationsDeleteCall) Context added in v0.53.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsOperationsDeleteCall) Do added in v0.53.0

Do executes the "pubsublite.admin.projects.locations.operations.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsOperationsDeleteCall) Fields added in v0.53.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsOperationsDeleteCall) Header added in v0.53.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsOperationsGetCall added in v0.53.0

type AdminProjectsLocationsOperationsGetCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsOperationsGetCall) Context added in v0.53.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsOperationsGetCall) Do added in v0.53.0

Do executes the "pubsublite.admin.projects.locations.operations.get" call. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsOperationsGetCall) Fields added in v0.53.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsOperationsGetCall) Header added in v0.53.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsOperationsGetCall) IfNoneMatch added in v0.53.0

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type AdminProjectsLocationsOperationsListCall added in v0.53.0

type AdminProjectsLocationsOperationsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsOperationsListCall) Context added in v0.53.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsOperationsListCall) Do added in v0.53.0

Do executes the "pubsublite.admin.projects.locations.operations.list" call. Any non-2xx status code is an error. Response headers are in either *ListOperationsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsOperationsListCall) Fields added in v0.53.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsOperationsListCall) Filter added in v0.53.0

Filter sets the optional parameter "filter": The standard list filter.

func (*AdminProjectsLocationsOperationsListCall) Header added in v0.53.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsOperationsListCall) IfNoneMatch added in v0.53.0

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsOperationsListCall) PageSize added in v0.53.0

PageSize sets the optional parameter "pageSize": The standard list page size.

func (*AdminProjectsLocationsOperationsListCall) PageToken added in v0.53.0

PageToken sets the optional parameter "pageToken": The standard list page token.

func (*AdminProjectsLocationsOperationsListCall) Pages added in v0.53.0

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsOperationsService added in v0.53.0

type AdminProjectsLocationsOperationsService struct {
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsOperationsService added in v0.53.0

func NewAdminProjectsLocationsOperationsService(s *Service) *AdminProjectsLocationsOperationsService

func (*AdminProjectsLocationsOperationsService) Cancel added in v0.53.0

Cancel: Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.

- name: The name of the operation resource to be cancelled.

func (*AdminProjectsLocationsOperationsService) Delete added in v0.53.0

Delete: Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.

- name: The name of the operation resource to be deleted.

func (*AdminProjectsLocationsOperationsService) Get added in v0.53.0

Get: Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

- name: The name of the operation resource.

func (*AdminProjectsLocationsOperationsService) List added in v0.53.0

List: Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

- name: The name of the operation's parent resource.

type AdminProjectsLocationsReservationsCreateCall added in v0.57.0

type AdminProjectsLocationsReservationsCreateCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsCreateCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsCreateCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.create" call. Any non-2xx status code is an error. Response headers are in either *Reservation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsCreateCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsCreateCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsReservationsCreateCall) ReservationId added in v0.57.0

ReservationId sets the optional parameter "reservationId": Required. The ID to use for the reservation, which will become the final component of the reservation's name. This value is structured like: `my-reservation-name`.

type AdminProjectsLocationsReservationsDeleteCall added in v0.57.0

type AdminProjectsLocationsReservationsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsDeleteCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsDeleteCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsDeleteCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsDeleteCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsReservationsGetCall added in v0.57.0

type AdminProjectsLocationsReservationsGetCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsGetCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsGetCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.get" call. Any non-2xx status code is an error. Response headers are in either *Reservation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsGetCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsGetCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsReservationsGetCall) IfNoneMatch added in v0.57.0

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type AdminProjectsLocationsReservationsListCall added in v0.57.0

type AdminProjectsLocationsReservationsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsListCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsListCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.list" call. Any non-2xx status code is an error. Response headers are in either *ListReservationsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsListCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsListCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsReservationsListCall) IfNoneMatch added in v0.57.0

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsReservationsListCall) PageSize added in v0.57.0

PageSize sets the optional parameter "pageSize": The maximum number of reservations to return. The service may return fewer than this value. If unset or zero, all reservations for the parent will be returned.

func (*AdminProjectsLocationsReservationsListCall) PageToken added in v0.57.0

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListReservations` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReservations` must match the call that provided the page token.

func (*AdminProjectsLocationsReservationsListCall) Pages added in v0.57.0

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsReservationsPatchCall added in v0.57.0

type AdminProjectsLocationsReservationsPatchCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsPatchCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsPatchCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.patch" call. Any non-2xx status code is an error. Response headers are in either *Reservation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsPatchCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsPatchCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsReservationsPatchCall) UpdateMask added in v0.57.0

UpdateMask sets the optional parameter "updateMask": Required. A mask specifying the reservation fields to change.

type AdminProjectsLocationsReservationsService added in v0.57.0

type AdminProjectsLocationsReservationsService struct {
	Topics *AdminProjectsLocationsReservationsTopicsService
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsReservationsService added in v0.57.0

func NewAdminProjectsLocationsReservationsService(s *Service) *AdminProjectsLocationsReservationsService

func (*AdminProjectsLocationsReservationsService) Create added in v0.57.0

Create: Creates a new reservation.

  • parent: The parent location in which to create the reservation. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsReservationsService) Delete added in v0.57.0

Delete: Deletes the specified reservation.

  • name: The name of the reservation to delete. Structured like: projects/{project_number}/locations/{location}/reservations/{reservation_id }.

func (*AdminProjectsLocationsReservationsService) Get added in v0.57.0

Get: Returns the reservation configuration.

  • name: The name of the reservation whose configuration to return. Structured like: projects/{project_number}/locations/{location}/reservations/{reservation_id }.

func (*AdminProjectsLocationsReservationsService) List added in v0.57.0

List: Returns the list of reservations for the given project.

  • parent: The parent whose reservations are to be listed. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsReservationsService) Patch added in v0.57.0

Patch: Updates properties of the specified reservation.

  • name: The name of the reservation. Structured like: projects/{project_number}/locations/{location}/reservations/{reservation_id }.

type AdminProjectsLocationsReservationsTopicsListCall added in v0.57.0

type AdminProjectsLocationsReservationsTopicsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsReservationsTopicsListCall) Context added in v0.57.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsReservationsTopicsListCall) Do added in v0.57.0

Do executes the "pubsublite.admin.projects.locations.reservations.topics.list" call. Any non-2xx status code is an error. Response headers are in either *ListReservationTopicsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsReservationsTopicsListCall) Fields added in v0.57.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsReservationsTopicsListCall) Header added in v0.57.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsReservationsTopicsListCall) IfNoneMatch added in v0.57.0

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsReservationsTopicsListCall) PageSize added in v0.57.0

PageSize sets the optional parameter "pageSize": The maximum number of topics to return. The service may return fewer than this value. If unset or zero, all topics for the given reservation will be returned.

func (*AdminProjectsLocationsReservationsTopicsListCall) PageToken added in v0.57.0

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListReservationTopics` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReservationTopics` must match the call that provided the page token.

func (*AdminProjectsLocationsReservationsTopicsListCall) Pages added in v0.57.0

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsReservationsTopicsService added in v0.57.0

type AdminProjectsLocationsReservationsTopicsService struct {
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsReservationsTopicsService added in v0.57.0

func NewAdminProjectsLocationsReservationsTopicsService(s *Service) *AdminProjectsLocationsReservationsTopicsService

func (*AdminProjectsLocationsReservationsTopicsService) List added in v0.57.0

List: Lists the topics attached to the specified reservation.

  • name: The name of the reservation whose topics to list. Structured like: projects/{project_number}/locations/{location}/reservations/{reservation_id }.

type AdminProjectsLocationsService

type AdminProjectsLocationsService struct {
	Operations *AdminProjectsLocationsOperationsService

	Reservations *AdminProjectsLocationsReservationsService

	Subscriptions *AdminProjectsLocationsSubscriptionsService

	Topics *AdminProjectsLocationsTopicsService
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsService

func NewAdminProjectsLocationsService(s *Service) *AdminProjectsLocationsService

type AdminProjectsLocationsSubscriptionsCreateCall

type AdminProjectsLocationsSubscriptionsCreateCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsCreateCall) Do

Do executes the "pubsublite.admin.projects.locations.subscriptions.create" call. Any non-2xx status code is an error. Response headers are in either *Subscription.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsCreateCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsSubscriptionsCreateCall) SkipBacklog added in v0.43.0

SkipBacklog sets the optional parameter "skipBacklog": If true, the newly created subscription will only receive messages published after the subscription was created. Otherwise, the entire message backlog will be received on the subscription. Defaults to false.

func (*AdminProjectsLocationsSubscriptionsCreateCall) SubscriptionId

SubscriptionId sets the optional parameter "subscriptionId": Required. The ID to use for the subscription, which will become the final component of the subscription's name. This value is structured like: `my-sub-name`.

type AdminProjectsLocationsSubscriptionsDeleteCall

type AdminProjectsLocationsSubscriptionsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsDeleteCall) Do

Do executes the "pubsublite.admin.projects.locations.subscriptions.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsDeleteCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsSubscriptionsGetCall

type AdminProjectsLocationsSubscriptionsGetCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsGetCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsGetCall) Do

Do executes the "pubsublite.admin.projects.locations.subscriptions.get" call. Any non-2xx status code is an error. Response headers are in either *Subscription.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsGetCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsSubscriptionsGetCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type AdminProjectsLocationsSubscriptionsListCall

type AdminProjectsLocationsSubscriptionsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsListCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsListCall) Do

Do executes the "pubsublite.admin.projects.locations.subscriptions.list" call. Any non-2xx status code is an error. Response headers are in either *ListSubscriptionsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsListCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsSubscriptionsListCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsSubscriptionsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of subscriptions to return. The service may return fewer than this value. If unset or zero, all subscriptions for the parent will be returned.

func (*AdminProjectsLocationsSubscriptionsListCall) PageToken

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscriptions` must match the call that provided the page token.

func (*AdminProjectsLocationsSubscriptionsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsSubscriptionsPatchCall

type AdminProjectsLocationsSubscriptionsPatchCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsPatchCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsPatchCall) Do

Do executes the "pubsublite.admin.projects.locations.subscriptions.patch" call. Any non-2xx status code is an error. Response headers are in either *Subscription.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsPatchCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsPatchCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsSubscriptionsPatchCall) UpdateMask

UpdateMask sets the optional parameter "updateMask": Required. A mask specifying the subscription fields to change.

type AdminProjectsLocationsSubscriptionsSeekCall added in v0.53.0

type AdminProjectsLocationsSubscriptionsSeekCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsSubscriptionsSeekCall) Context added in v0.53.0

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsSubscriptionsSeekCall) Do added in v0.53.0

Do executes the "pubsublite.admin.projects.locations.subscriptions.seek" call. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsSubscriptionsSeekCall) Fields added in v0.53.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsSubscriptionsSeekCall) Header added in v0.53.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsSubscriptionsService

type AdminProjectsLocationsSubscriptionsService struct {
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsSubscriptionsService

func NewAdminProjectsLocationsSubscriptionsService(s *Service) *AdminProjectsLocationsSubscriptionsService

func (*AdminProjectsLocationsSubscriptionsService) Create

Create: Creates a new subscription.

  • parent: The parent location in which to create the subscription. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsSubscriptionsService) Delete

Delete: Deletes the specified subscription.

- name: The name of the subscription to delete.

func (*AdminProjectsLocationsSubscriptionsService) Get

Get: Returns the subscription configuration.

- name: The name of the subscription whose configuration to return.

func (*AdminProjectsLocationsSubscriptionsService) List

List: Returns the list of subscriptions for the given project.

  • parent: The parent whose subscriptions are to be listed. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsSubscriptionsService) Patch

Patch: Updates properties of the specified subscription.

  • name: The name of the subscription. Structured like: projects/{project_number}/locations/{location}/subscriptions/{subscription_ id}.

func (*AdminProjectsLocationsSubscriptionsService) Seek added in v0.53.0

Seek: Performs an out-of-band seek for a subscription to a specified target, which may be timestamps or named positions within the message backlog. Seek translates these targets to cursors for each partition and orchestrates subscribers to start consuming messages from these seek cursors. If an operation is returned, the seek has been registered and subscribers will eventually receive messages from the seek cursors (i.e. eventual consistency), as long as they are using a minimum supported client library version and not a system that tracks cursors independently of Pub/Sub Lite (e.g. Apache Beam, Dataflow, Spark). The seek operation will fail for unsupported clients. If clients would like to know when subscribers react to the seek (or not), they can poll the operation. The seek operation will succeed and complete once subscribers are ready to receive messages from the seek cursors for all partitions of the topic. This means that the seek operation will not complete until all subscribers come online. If the previous seek operation has not yet completed, it will be aborted and the new invocation of seek will supersede it.

- name: The name of the subscription to seek.

type AdminProjectsLocationsTopicsCreateCall

type AdminProjectsLocationsTopicsCreateCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsCreateCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.create" call. Any non-2xx status code is an error. Response headers are in either *Topic.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsCreateCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsCreateCall) TopicId

TopicId sets the optional parameter "topicId": Required. The ID to use for the topic, which will become the final component of the topic's name. This value is structured like: `my-topic-name`.

type AdminProjectsLocationsTopicsDeleteCall

type AdminProjectsLocationsTopicsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsDeleteCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsDeleteCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type AdminProjectsLocationsTopicsGetCall

type AdminProjectsLocationsTopicsGetCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsGetCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsGetCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.get" call. Any non-2xx status code is an error. Response headers are in either *Topic.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsGetCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsGetCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type AdminProjectsLocationsTopicsGetPartitionsCall

type AdminProjectsLocationsTopicsGetPartitionsCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsGetPartitionsCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsGetPartitionsCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.getPartitions" call. Any non-2xx status code is an error. Response headers are in either *TopicPartitions.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsGetPartitionsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsGetPartitionsCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsGetPartitionsCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

type AdminProjectsLocationsTopicsListCall

type AdminProjectsLocationsTopicsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsListCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsListCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.list" call. Any non-2xx status code is an error. Response headers are in either *ListTopicsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsListCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsListCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsTopicsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of topics to return. The service may return fewer than this value. If unset or zero, all topics for the parent will be returned.

func (*AdminProjectsLocationsTopicsListCall) PageToken

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListTopics` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTopics` must match the call that provided the page token.

func (*AdminProjectsLocationsTopicsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsTopicsPatchCall

type AdminProjectsLocationsTopicsPatchCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsPatchCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsPatchCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.patch" call. Any non-2xx status code is an error. Response headers are in either *Topic.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsPatchCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsPatchCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsPatchCall) UpdateMask

UpdateMask sets the optional parameter "updateMask": Required. A mask specifying the topic fields to change.

type AdminProjectsLocationsTopicsService

type AdminProjectsLocationsTopicsService struct {
	Subscriptions *AdminProjectsLocationsTopicsSubscriptionsService
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsTopicsService

func NewAdminProjectsLocationsTopicsService(s *Service) *AdminProjectsLocationsTopicsService

func (*AdminProjectsLocationsTopicsService) Create

Create: Creates a new topic.

  • parent: The parent location in which to create the topic. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsTopicsService) Delete

Delete: Deletes the specified topic.

- name: The name of the topic to delete.

func (*AdminProjectsLocationsTopicsService) Get

Get: Returns the topic configuration.

- name: The name of the topic whose configuration to return.

func (*AdminProjectsLocationsTopicsService) GetPartitions

GetPartitions: Returns the partition information for the requested topic.

- name: The topic whose partition information to return.

func (*AdminProjectsLocationsTopicsService) List

List: Returns the list of topics for the given project.

  • parent: The parent whose topics are to be listed. Structured like `projects/{project_number}/locations/{location}`.

func (*AdminProjectsLocationsTopicsService) Patch

Patch: Updates properties of the specified topic.

  • name: The name of the topic. Structured like: projects/{project_number}/locations/{location}/topics/{topic_id}.

type AdminProjectsLocationsTopicsSubscriptionsListCall

type AdminProjectsLocationsTopicsSubscriptionsListCall struct {
	// contains filtered or unexported fields
}

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) Context

Context sets the context to be used in this call's Do method.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) Do

Do executes the "pubsublite.admin.projects.locations.topics.subscriptions.list" call. Any non-2xx status code is an error. Response headers are in either *ListTopicSubscriptionsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of subscriptions to return. The service may return fewer than this value. If unset or zero, all subscriptions for the given topic will be returned.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) PageToken

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListTopicSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTopicSubscriptions` must match the call that provided the page token.

func (*AdminProjectsLocationsTopicsSubscriptionsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type AdminProjectsLocationsTopicsSubscriptionsService

type AdminProjectsLocationsTopicsSubscriptionsService struct {
	// contains filtered or unexported fields
}

func NewAdminProjectsLocationsTopicsSubscriptionsService

func NewAdminProjectsLocationsTopicsSubscriptionsService(s *Service) *AdminProjectsLocationsTopicsSubscriptionsService

func (*AdminProjectsLocationsTopicsSubscriptionsService) List

List: Lists the subscriptions attached to the specified topic.

- name: The name of the topic whose subscriptions to list.

type AdminProjectsService

type AdminProjectsService struct {
	Locations *AdminProjectsLocationsService
	// contains filtered or unexported fields
}

func NewAdminProjectsService

func NewAdminProjectsService(s *Service) *AdminProjectsService

type AdminService

type AdminService struct {
	Projects *AdminProjectsService
	// contains filtered or unexported fields
}

func NewAdminService

func NewAdminService(s *Service) *AdminService

type CancelOperationRequest added in v0.53.0

type CancelOperationRequest struct {
}

CancelOperationRequest: The request message for Operations.CancelOperation.

type Capacity

type Capacity struct {
	// PublishMibPerSec: Publish throughput capacity per partition in MiB/s. Must
	// be >= 4 and <= 16.
	PublishMibPerSec int64 `json:"publishMibPerSec,omitempty"`
	// SubscribeMibPerSec: Subscribe throughput capacity per partition in MiB/s.
	// Must be >= 4 and <= 32.
	SubscribeMibPerSec int64 `json:"subscribeMibPerSec,omitempty"`
	// ForceSendFields is a list of field names (e.g. "PublishMibPerSec") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "PublishMibPerSec") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Capacity: The throughput capacity configuration for each partition.

func (Capacity) MarshalJSON

func (s Capacity) MarshalJSON() ([]byte, error)

type CommitCursorRequest added in v0.47.0

type CommitCursorRequest struct {
	// Cursor: The new value for the committed cursor.
	Cursor *Cursor `json:"cursor,omitempty"`
	// Partition: The partition for which to update the cursor. Partitions are zero
	// indexed, so `partition` must be in the range [0, topic.num_partitions).
	Partition int64 `json:"partition,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

CommitCursorRequest: Request for CommitCursor.

func (CommitCursorRequest) MarshalJSON added in v0.47.0

func (s CommitCursorRequest) MarshalJSON() ([]byte, error)

type CommitCursorResponse added in v0.47.0

type CommitCursorResponse struct {
	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
}

CommitCursorResponse: Response for CommitCursor.

type ComputeHeadCursorRequest added in v0.40.0

type ComputeHeadCursorRequest struct {
	// Partition: Required. The partition for which we should compute the head
	// cursor.
	Partition int64 `json:"partition,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Partition") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Partition") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeHeadCursorRequest: Compute the current head cursor for a partition.

func (ComputeHeadCursorRequest) MarshalJSON added in v0.40.0

func (s ComputeHeadCursorRequest) MarshalJSON() ([]byte, error)

type ComputeHeadCursorResponse added in v0.40.0

type ComputeHeadCursorResponse struct {
	// HeadCursor: The head cursor.
	HeadCursor *Cursor `json:"headCursor,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "HeadCursor") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "HeadCursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeHeadCursorResponse: Response containing the head cursor for the requested topic and partition.

func (ComputeHeadCursorResponse) MarshalJSON added in v0.40.0

func (s ComputeHeadCursorResponse) MarshalJSON() ([]byte, error)

type ComputeMessageStatsRequest added in v0.33.0

type ComputeMessageStatsRequest struct {
	// EndCursor: The exclusive end of the range. The range is empty if end_cursor
	// <= start_cursor. Specifying a start_cursor before the first message and an
	// end_cursor after the last message will retrieve all messages.
	EndCursor *Cursor `json:"endCursor,omitempty"`
	// Partition: Required. The partition for which we should compute message
	// stats.
	Partition int64 `json:"partition,omitempty,string"`
	// StartCursor: The inclusive start of the range.
	StartCursor *Cursor `json:"startCursor,omitempty"`
	// ForceSendFields is a list of field names (e.g. "EndCursor") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "EndCursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeMessageStatsRequest: Compute statistics about a range of messages in a given topic and partition.

func (ComputeMessageStatsRequest) MarshalJSON added in v0.33.0

func (s ComputeMessageStatsRequest) MarshalJSON() ([]byte, error)

type ComputeMessageStatsResponse added in v0.33.0

type ComputeMessageStatsResponse struct {
	// MessageBytes: The number of quota bytes accounted to these messages.
	MessageBytes int64 `json:"messageBytes,omitempty,string"`
	// MessageCount: The count of messages.
	MessageCount int64 `json:"messageCount,omitempty,string"`
	// MinimumEventTime: The minimum event timestamp across these messages. For the
	// purposes of this computation, if a message does not have an event time, we
	// use the publish time. The timestamp will be unset if there are no messages.
	MinimumEventTime string `json:"minimumEventTime,omitempty"`
	// MinimumPublishTime: The minimum publish timestamp across these messages.
	// Note that publish timestamps within a partition are not guaranteed to be
	// non-decreasing. The timestamp will be unset if there are no messages.
	MinimumPublishTime string `json:"minimumPublishTime,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "MessageBytes") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "MessageBytes") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeMessageStatsResponse: Response containing stats for messages in the requested topic and partition.

func (ComputeMessageStatsResponse) MarshalJSON added in v0.33.0

func (s ComputeMessageStatsResponse) MarshalJSON() ([]byte, error)

type ComputeTimeCursorRequest added in v0.47.0

type ComputeTimeCursorRequest struct {
	// Partition: Required. The partition for which we should compute the cursor.
	Partition int64 `json:"partition,omitempty,string"`
	// Target: Required. The target publish or event time. Specifying a future time
	// will return an unset cursor.
	Target *TimeTarget `json:"target,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Partition") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Partition") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeTimeCursorRequest: Compute the corresponding cursor for a publish or event time in a topic partition.

func (ComputeTimeCursorRequest) MarshalJSON added in v0.47.0

func (s ComputeTimeCursorRequest) MarshalJSON() ([]byte, error)

type ComputeTimeCursorResponse added in v0.47.0

type ComputeTimeCursorResponse struct {
	// Cursor: If present, the cursor references the first message with time
	// greater than or equal to the specified target time. If such a message cannot
	// be found, the cursor will be unset (i.e. `cursor` is not present).
	Cursor *Cursor `json:"cursor,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ComputeTimeCursorResponse: Response containing the cursor corresponding to a publish or event time in a topic partition.

func (ComputeTimeCursorResponse) MarshalJSON added in v0.47.0

func (s ComputeTimeCursorResponse) MarshalJSON() ([]byte, error)

type Cursor

type Cursor struct {
	// Offset: The offset of a message within a topic partition. Must be greater
	// than or equal 0.
	Offset int64 `json:"offset,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Offset") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Offset") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Cursor: A cursor that describes the position of a message within a topic partition.

func (Cursor) MarshalJSON

func (s Cursor) MarshalJSON() ([]byte, error)

type CursorProjectsLocationsService

type CursorProjectsLocationsService struct {
	Subscriptions *CursorProjectsLocationsSubscriptionsService
	// contains filtered or unexported fields
}

func NewCursorProjectsLocationsService

func NewCursorProjectsLocationsService(s *Service) *CursorProjectsLocationsService

type CursorProjectsLocationsSubscriptionsCommitCursorCall added in v0.47.0

type CursorProjectsLocationsSubscriptionsCommitCursorCall struct {
	// contains filtered or unexported fields
}

func (*CursorProjectsLocationsSubscriptionsCommitCursorCall) Context added in v0.47.0

Context sets the context to be used in this call's Do method.

func (*CursorProjectsLocationsSubscriptionsCommitCursorCall) Do added in v0.47.0

Do executes the "pubsublite.cursor.projects.locations.subscriptions.commitCursor" call. Any non-2xx status code is an error. Response headers are in either *CommitCursorResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*CursorProjectsLocationsSubscriptionsCommitCursorCall) Fields added in v0.47.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CursorProjectsLocationsSubscriptionsCommitCursorCall) Header added in v0.47.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type CursorProjectsLocationsSubscriptionsCursorsListCall

type CursorProjectsLocationsSubscriptionsCursorsListCall struct {
	// contains filtered or unexported fields
}

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) Context

Context sets the context to be used in this call's Do method.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) Do

Do executes the "pubsublite.cursor.projects.locations.subscriptions.cursors.list" call. Any non-2xx status code is an error. Response headers are in either *ListPartitionCursorsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) PageSize

PageSize sets the optional parameter "pageSize": The maximum number of cursors to return. The service may return fewer than this value. If unset or zero, all cursors for the parent will be returned.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) PageToken

PageToken sets the optional parameter "pageToken": A page token, received from a previous `ListPartitionCursors` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPartitionCursors` must match the call that provided the page token.

func (*CursorProjectsLocationsSubscriptionsCursorsListCall) Pages

Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.

type CursorProjectsLocationsSubscriptionsCursorsService

type CursorProjectsLocationsSubscriptionsCursorsService struct {
	// contains filtered or unexported fields
}

func (*CursorProjectsLocationsSubscriptionsCursorsService) List

List: Returns all committed cursor information for a subscription.

  • parent: The subscription for which to retrieve cursors. Structured like `projects/{project_number}/locations/{location}/subscriptions/{subscription _id}`.

type CursorProjectsLocationsSubscriptionsService

type CursorProjectsLocationsSubscriptionsService struct {
	Cursors *CursorProjectsLocationsSubscriptionsCursorsService
	// contains filtered or unexported fields
}

func NewCursorProjectsLocationsSubscriptionsService

func NewCursorProjectsLocationsSubscriptionsService(s *Service) *CursorProjectsLocationsSubscriptionsService

func (*CursorProjectsLocationsSubscriptionsService) CommitCursor added in v0.47.0

CommitCursor: Updates the committed cursor.

- subscription: The subscription for which to update the cursor.

type CursorProjectsService

type CursorProjectsService struct {
	Locations *CursorProjectsLocationsService
	// contains filtered or unexported fields
}

func NewCursorProjectsService

func NewCursorProjectsService(s *Service) *CursorProjectsService

type CursorService

type CursorService struct {
	Projects *CursorProjectsService
	// contains filtered or unexported fields
}

func NewCursorService

func NewCursorService(s *Service) *CursorService

type DeliveryConfig

type DeliveryConfig struct {
	// DeliveryRequirement: The DeliveryRequirement for this subscription.
	//
	// Possible values:
	//   "DELIVERY_REQUIREMENT_UNSPECIFIED" - Default value. This value is unused.
	//   "DELIVER_IMMEDIATELY" - The server does not wait for a published message
	// to be successfully written to storage before delivering it to subscribers.
	//   "DELIVER_AFTER_STORED" - The server will not deliver a published message
	// to subscribers until the message has been successfully written to storage.
	// This will result in higher end-to-end latency, but consistent delivery.
	DeliveryRequirement string `json:"deliveryRequirement,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DeliveryRequirement") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DeliveryRequirement") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DeliveryConfig: The settings for a subscription's message delivery.

func (DeliveryConfig) MarshalJSON

func (s DeliveryConfig) MarshalJSON() ([]byte, error)

type Empty

type Empty struct {
	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
}

Empty: A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

type ExportConfig added in v0.106.0

type ExportConfig struct {
	// CurrentState: Output only. The current state of the export, which may be
	// different to the desired state due to errors. This field is output only.
	//
	// Possible values:
	//   "STATE_UNSPECIFIED" - Default value. This value is unused.
	//   "ACTIVE" - Messages are being exported.
	//   "PAUSED" - Exporting messages is suspended.
	//   "PERMISSION_DENIED" - Messages cannot be exported due to permission denied
	// errors. Output only.
	//   "NOT_FOUND" - Messages cannot be exported due to missing resources. Output
	// only.
	CurrentState string `json:"currentState,omitempty"`
	// DeadLetterTopic: Optional. The name of an optional Pub/Sub Lite topic to
	// publish messages that can not be exported to the destination. For example,
	// the message can not be published to the Pub/Sub service because it does not
	// satisfy the constraints documented at
	// https://cloud.google.com/pubsub/docs/publisher. Structured like:
	// projects/{project_number}/locations/{location}/topics/{topic_id}. Must be
	// within the same project and location as the subscription. The topic may be
	// changed or removed.
	DeadLetterTopic string `json:"deadLetterTopic,omitempty"`
	// DesiredState: The desired state of this export. Setting this to values other
	// than `ACTIVE` and `PAUSED` will result in an error.
	//
	// Possible values:
	//   "STATE_UNSPECIFIED" - Default value. This value is unused.
	//   "ACTIVE" - Messages are being exported.
	//   "PAUSED" - Exporting messages is suspended.
	//   "PERMISSION_DENIED" - Messages cannot be exported due to permission denied
	// errors. Output only.
	//   "NOT_FOUND" - Messages cannot be exported due to missing resources. Output
	// only.
	DesiredState string `json:"desiredState,omitempty"`
	// PubsubConfig: Messages are automatically written from the Pub/Sub Lite topic
	// associated with this subscription to a Pub/Sub topic.
	PubsubConfig *PubSubConfig `json:"pubsubConfig,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CurrentState") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CurrentState") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ExportConfig: Configuration for a Pub/Sub Lite subscription that writes messages to a destination. User subscriber clients must not connect to this subscription.

func (ExportConfig) MarshalJSON added in v0.106.0

func (s ExportConfig) MarshalJSON() ([]byte, error)

type ListOperationsResponse added in v0.53.0

type ListOperationsResponse struct {
	// NextPageToken: The standard List next-page token.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Operations: A list of operations that matches the specified filter in the
	// request.
	Operations []*Operation `json:"operations,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListOperationsResponse: The response message for Operations.ListOperations.

func (ListOperationsResponse) MarshalJSON added in v0.53.0

func (s ListOperationsResponse) MarshalJSON() ([]byte, error)

type ListPartitionCursorsResponse

type ListPartitionCursorsResponse struct {
	// NextPageToken: A token, which can be sent as `page_token` to retrieve the
	// next page. If this field is omitted, there are no subsequent pages.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// PartitionCursors: The partition cursors from this request.
	PartitionCursors []*PartitionCursor `json:"partitionCursors,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListPartitionCursorsResponse: Response for ListPartitionCursors

func (ListPartitionCursorsResponse) MarshalJSON

func (s ListPartitionCursorsResponse) MarshalJSON() ([]byte, error)

type ListReservationTopicsResponse added in v0.57.0

type ListReservationTopicsResponse struct {
	// NextPageToken: A token that can be sent as `page_token` to retrieve the next
	// page of results. If this field is omitted, there are no more results.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Topics: The names of topics attached to the reservation. The order of the
	// topics is unspecified.
	Topics []string `json:"topics,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListReservationTopicsResponse: Response for ListReservationTopics.

func (ListReservationTopicsResponse) MarshalJSON added in v0.57.0

func (s ListReservationTopicsResponse) MarshalJSON() ([]byte, error)

type ListReservationsResponse added in v0.57.0

type ListReservationsResponse struct {
	// NextPageToken: A token that can be sent as `page_token` to retrieve the next
	// page of results. If this field is omitted, there are no more results.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Reservations: The list of reservation in the requested parent. The order of
	// the reservations is unspecified.
	Reservations []*Reservation `json:"reservations,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListReservationsResponse: Response for ListReservations.

func (ListReservationsResponse) MarshalJSON added in v0.57.0

func (s ListReservationsResponse) MarshalJSON() ([]byte, error)

type ListSubscriptionsResponse

type ListSubscriptionsResponse struct {
	// NextPageToken: A token that can be sent as `page_token` to retrieve the next
	// page of results. If this field is omitted, there are no more results.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Subscriptions: The list of subscriptions in the requested parent. The order
	// of the subscriptions is unspecified.
	Subscriptions []*Subscription `json:"subscriptions,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListSubscriptionsResponse: Response for ListSubscriptions.

func (ListSubscriptionsResponse) MarshalJSON

func (s ListSubscriptionsResponse) MarshalJSON() ([]byte, error)

type ListTopicSubscriptionsResponse

type ListTopicSubscriptionsResponse struct {
	// NextPageToken: A token that can be sent as `page_token` to retrieve the next
	// page of results. If this field is omitted, there are no more results.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Subscriptions: The names of subscriptions attached to the topic. The order
	// of the subscriptions is unspecified.
	Subscriptions []string `json:"subscriptions,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListTopicSubscriptionsResponse: Response for ListTopicSubscriptions.

func (ListTopicSubscriptionsResponse) MarshalJSON

func (s ListTopicSubscriptionsResponse) MarshalJSON() ([]byte, error)

type ListTopicsResponse

type ListTopicsResponse struct {
	// NextPageToken: A token that can be sent as `page_token` to retrieve the next
	// page of results. If this field is omitted, there are no more results.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Topics: The list of topic in the requested parent. The order of the topics
	// is unspecified.
	Topics []*Topic `json:"topics,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "NextPageToken") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NextPageToken") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ListTopicsResponse: Response for ListTopics.

func (ListTopicsResponse) MarshalJSON

func (s ListTopicsResponse) MarshalJSON() ([]byte, error)

type Operation added in v0.53.0

type Operation struct {
	// Done: If the value is `false`, it means the operation is still in progress.
	// If `true`, the operation is completed, and either `error` or `response` is
	// available.
	Done bool `json:"done,omitempty"`
	// Error: The error result of the operation in case of failure or cancellation.
	Error *Status `json:"error,omitempty"`
	// Metadata: Service-specific metadata associated with the operation. It
	// typically contains progress information and common metadata such as create
	// time. Some services might not provide such metadata. Any method that returns
	// a long-running operation should document the metadata type, if any.
	Metadata googleapi.RawMessage `json:"metadata,omitempty"`
	// Name: The server-assigned name, which is only unique within the same service
	// that originally returns it. If you use the default HTTP mapping, the `name`
	// should be a resource name ending with `operations/{unique_id}`.
	Name string `json:"name,omitempty"`
	// Response: The normal, successful response of the operation. If the original
	// method returns no data on success, such as `Delete`, the response is
	// `google.protobuf.Empty`. If the original method is standard
	// `Get`/`Create`/`Update`, the response should be the resource. For other
	// methods, the response should have the type `XxxResponse`, where `Xxx` is the
	// original method name. For example, if the original method name is
	// `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
	Response googleapi.RawMessage `json:"response,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Done") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Done") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Operation: This resource represents a long-running operation that is the result of a network API call.

func (Operation) MarshalJSON added in v0.53.0

func (s Operation) MarshalJSON() ([]byte, error)

type OperationMetadata added in v0.53.0

type OperationMetadata struct {
	// CreateTime: The time the operation was created.
	CreateTime string `json:"createTime,omitempty"`
	// EndTime: The time the operation finished running. Not set if the operation
	// has not completed.
	EndTime string `json:"endTime,omitempty"`
	// Target: Resource path for the target of the operation. For example, targets
	// of seeks are subscription resources, structured like:
	// projects/{project_number}/locations/{location}/subscriptions/{subscription_id
	// }
	Target string `json:"target,omitempty"`
	// Verb: Name of the verb executed by the operation.
	Verb string `json:"verb,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CreateTime") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CreateTime") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

OperationMetadata: Metadata for long running operations.

func (OperationMetadata) MarshalJSON added in v0.53.0

func (s OperationMetadata) MarshalJSON() ([]byte, error)

type PartitionConfig

type PartitionConfig struct {
	// Capacity: The capacity configuration.
	Capacity *Capacity `json:"capacity,omitempty"`
	// Count: The number of partitions in the topic. Must be at least 1. Once a
	// topic has been created the number of partitions can be increased but not
	// decreased. Message ordering is not guaranteed across a topic resize. For
	// more information see
	// https://cloud.google.com/pubsub/lite/docs/topics#scaling_capacity
	Count int64 `json:"count,omitempty,string"`
	// Scale: DEPRECATED: Use capacity instead which can express a superset of
	// configurations. Every partition in the topic is allocated throughput
	// equivalent to `scale` times the standard partition throughput (4 MiB/s).
	// This is also reflected in the cost of this topic; a topic with `scale` of 2
	// and count of 10 is charged for 20 partitions. This value must be in the
	// range [1,4].
	Scale int64 `json:"scale,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Capacity") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Capacity") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

PartitionConfig: The settings for a topic's partitions.

func (PartitionConfig) MarshalJSON

func (s PartitionConfig) MarshalJSON() ([]byte, error)

type PartitionCursor

type PartitionCursor struct {
	// Cursor: The value of the cursor.
	Cursor *Cursor `json:"cursor,omitempty"`
	// Partition: The partition this is for.
	Partition int64 `json:"partition,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Cursor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Cursor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

PartitionCursor: A pair of a Cursor and the partition it is for.

func (PartitionCursor) MarshalJSON

func (s PartitionCursor) MarshalJSON() ([]byte, error)

type PubSubConfig added in v0.106.0

type PubSubConfig struct {
	// Topic: The name of the Pub/Sub topic. Structured like:
	// projects/{project_number}/topics/{topic_id}. The topic may be changed.
	Topic string `json:"topic,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Topic") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Topic") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

PubSubConfig: Configuration for exporting to a Pub/Sub topic.

func (PubSubConfig) MarshalJSON added in v0.106.0

func (s PubSubConfig) MarshalJSON() ([]byte, error)

type Reservation added in v0.57.0

type Reservation struct {
	// Name: The name of the reservation. Structured like:
	// projects/{project_number}/locations/{location}/reservations/{reservation_id}
	Name string `json:"name,omitempty"`
	// ThroughputCapacity: The reserved throughput capacity. Every unit of
	// throughput capacity is equivalent to 1 MiB/s of published messages or 2
	// MiB/s of subscribed messages. Any topics which are declared as using
	// capacity from a Reservation will consume resources from this reservation
	// instead of being charged individually.
	ThroughputCapacity int64 `json:"throughputCapacity,omitempty,string"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Name") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Name") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Reservation: Metadata about a reservation resource.

func (Reservation) MarshalJSON added in v0.57.0

func (s Reservation) MarshalJSON() ([]byte, error)

type ReservationConfig added in v0.57.0

type ReservationConfig struct {
	// ThroughputReservation: The Reservation to use for this topic's throughput
	// capacity. Structured like:
	// projects/{project_number}/locations/{location}/reservations/{reservation_id}
	ThroughputReservation string `json:"throughputReservation,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ThroughputReservation") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ThroughputReservation") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ReservationConfig: The settings for this topic's Reservation usage.

func (ReservationConfig) MarshalJSON added in v0.57.0

func (s ReservationConfig) MarshalJSON() ([]byte, error)

type RetentionConfig

type RetentionConfig struct {
	// PerPartitionBytes: The provisioned storage, in bytes, per partition. If the
	// number of bytes stored in any of the topic's partitions grows beyond this
	// value, older messages will be dropped to make room for newer ones,
	// regardless of the value of `period`.
	PerPartitionBytes int64 `json:"perPartitionBytes,omitempty,string"`
	// Period: How long a published message is retained. If unset, messages will be
	// retained as long as the bytes retained for each partition is below
	// `per_partition_bytes`.
	Period string `json:"period,omitempty"`
	// ForceSendFields is a list of field names (e.g. "PerPartitionBytes") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "PerPartitionBytes") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RetentionConfig: The settings for a topic's message retention.

func (RetentionConfig) MarshalJSON

func (s RetentionConfig) MarshalJSON() ([]byte, error)

type SeekSubscriptionRequest added in v0.53.0

type SeekSubscriptionRequest struct {
	// NamedTarget: Seek to a named position with respect to the message backlog.
	//
	// Possible values:
	//   "NAMED_TARGET_UNSPECIFIED" - Unspecified named target. Do not use.
	//   "TAIL" - Seek to the oldest retained message.
	//   "HEAD" - Seek past all recently published messages, skipping the entire
	// message backlog.
	NamedTarget string `json:"namedTarget,omitempty"`
	// TimeTarget: Seek to the first message whose publish or event time is greater
	// than or equal to the specified query time. If no such message can be
	// located, will seek to the end of the message backlog.
	TimeTarget *TimeTarget `json:"timeTarget,omitempty"`
	// ForceSendFields is a list of field names (e.g. "NamedTarget") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "NamedTarget") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

SeekSubscriptionRequest: Request for SeekSubscription.

func (SeekSubscriptionRequest) MarshalJSON added in v0.53.0

func (s SeekSubscriptionRequest) MarshalJSON() ([]byte, error)

type SeekSubscriptionResponse added in v0.53.0

type SeekSubscriptionResponse struct {
}

SeekSubscriptionResponse: Response for SeekSubscription long running operation.

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Admin *AdminService

	Cursor *CursorService

	TopicStats *TopicStatsService
	// contains filtered or unexported fields
}

func New deprecated

func New(client *http.Client) (*Service, error)

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

func NewService

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type Status added in v0.53.0

type Status struct {
	// Code: The status code, which should be an enum value of google.rpc.Code.
	Code int64 `json:"code,omitempty"`
	// Details: A list of messages that carry the error details. There is a common
	// set of message types for APIs to use.
	Details []googleapi.RawMessage `json:"details,omitempty"`
	// Message: A developer-facing error message, which should be in English. Any
	// user-facing error message should be localized and sent in the
	// google.rpc.Status.details field, or localized by the client.
	Message string `json:"message,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Code") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Code") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Status: The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).

func (Status) MarshalJSON added in v0.53.0

func (s Status) MarshalJSON() ([]byte, error)

type Subscription

type Subscription struct {
	// DeliveryConfig: The settings for this subscription's message delivery.
	DeliveryConfig *DeliveryConfig `json:"deliveryConfig,omitempty"`
	// ExportConfig: If present, messages are automatically written from the
	// Pub/Sub Lite topic associated with this subscription to a destination.
	ExportConfig *ExportConfig `json:"exportConfig,omitempty"`
	// Name: The name of the subscription. Structured like:
	// projects/{project_number}/locations/{location}/subscriptions/{subscription_id
	// }
	Name string `json:"name,omitempty"`
	// Topic: The name of the topic this subscription is attached to. Structured
	// like: projects/{project_number}/locations/{location}/topics/{topic_id}
	Topic string `json:"topic,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "DeliveryConfig") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DeliveryConfig") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Subscription: Metadata about a subscription resource.

func (Subscription) MarshalJSON

func (s Subscription) MarshalJSON() ([]byte, error)

type TimeTarget added in v0.47.0

type TimeTarget struct {
	// EventTime: Request the cursor of the first message with event time greater
	// than or equal to `event_time`. If messages are missing an event time, the
	// publish time is used as a fallback. As event times are user supplied,
	// subsequent messages may have event times less than `event_time` and should
	// be filtered by the client, if necessary.
	EventTime string `json:"eventTime,omitempty"`
	// PublishTime: Request the cursor of the first message with publish time
	// greater than or equal to `publish_time`. All messages thereafter are
	// guaranteed to have publish times >= `publish_time`.
	PublishTime string `json:"publishTime,omitempty"`
	// ForceSendFields is a list of field names (e.g. "EventTime") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "EventTime") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TimeTarget: A target publish or event time. Can be used for seeking to or retrieving the corresponding cursor.

func (TimeTarget) MarshalJSON added in v0.47.0

func (s TimeTarget) MarshalJSON() ([]byte, error)

type Topic

type Topic struct {
	// Name: The name of the topic. Structured like:
	// projects/{project_number}/locations/{location}/topics/{topic_id}
	Name string `json:"name,omitempty"`
	// PartitionConfig: The settings for this topic's partitions.
	PartitionConfig *PartitionConfig `json:"partitionConfig,omitempty"`
	// ReservationConfig: The settings for this topic's Reservation usage.
	ReservationConfig *ReservationConfig `json:"reservationConfig,omitempty"`
	// RetentionConfig: The settings for this topic's message retention.
	RetentionConfig *RetentionConfig `json:"retentionConfig,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Name") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Name") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Topic: Metadata about a topic resource.

func (Topic) MarshalJSON

func (s Topic) MarshalJSON() ([]byte, error)

type TopicPartitions

type TopicPartitions struct {
	// PartitionCount: The number of partitions in the topic.
	PartitionCount int64 `json:"partitionCount,omitempty,string"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "PartitionCount") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "PartitionCount") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TopicPartitions: Response for GetTopicPartitions.

func (TopicPartitions) MarshalJSON

func (s TopicPartitions) MarshalJSON() ([]byte, error)

type TopicStatsProjectsLocationsService added in v0.33.0

type TopicStatsProjectsLocationsService struct {
	Topics *TopicStatsProjectsLocationsTopicsService
	// contains filtered or unexported fields
}

func NewTopicStatsProjectsLocationsService added in v0.33.0

func NewTopicStatsProjectsLocationsService(s *Service) *TopicStatsProjectsLocationsService

type TopicStatsProjectsLocationsTopicsComputeHeadCursorCall added in v0.40.0

type TopicStatsProjectsLocationsTopicsComputeHeadCursorCall struct {
	// contains filtered or unexported fields
}

func (*TopicStatsProjectsLocationsTopicsComputeHeadCursorCall) Context added in v0.40.0

Context sets the context to be used in this call's Do method.

func (*TopicStatsProjectsLocationsTopicsComputeHeadCursorCall) Do added in v0.40.0

Do executes the "pubsublite.topicStats.projects.locations.topics.computeHeadCursor" call. Any non-2xx status code is an error. Response headers are in either *ComputeHeadCursorResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TopicStatsProjectsLocationsTopicsComputeHeadCursorCall) Fields added in v0.40.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TopicStatsProjectsLocationsTopicsComputeHeadCursorCall) Header added in v0.40.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TopicStatsProjectsLocationsTopicsComputeMessageStatsCall added in v0.33.0

type TopicStatsProjectsLocationsTopicsComputeMessageStatsCall struct {
	// contains filtered or unexported fields
}

func (*TopicStatsProjectsLocationsTopicsComputeMessageStatsCall) Context added in v0.33.0

Context sets the context to be used in this call's Do method.

func (*TopicStatsProjectsLocationsTopicsComputeMessageStatsCall) Do added in v0.33.0

Do executes the "pubsublite.topicStats.projects.locations.topics.computeMessageStats" call. Any non-2xx status code is an error. Response headers are in either *ComputeMessageStatsResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TopicStatsProjectsLocationsTopicsComputeMessageStatsCall) Fields added in v0.33.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TopicStatsProjectsLocationsTopicsComputeMessageStatsCall) Header added in v0.33.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TopicStatsProjectsLocationsTopicsComputeTimeCursorCall added in v0.47.0

type TopicStatsProjectsLocationsTopicsComputeTimeCursorCall struct {
	// contains filtered or unexported fields
}

func (*TopicStatsProjectsLocationsTopicsComputeTimeCursorCall) Context added in v0.47.0

Context sets the context to be used in this call's Do method.

func (*TopicStatsProjectsLocationsTopicsComputeTimeCursorCall) Do added in v0.47.0

Do executes the "pubsublite.topicStats.projects.locations.topics.computeTimeCursor" call. Any non-2xx status code is an error. Response headers are in either *ComputeTimeCursorResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.

func (*TopicStatsProjectsLocationsTopicsComputeTimeCursorCall) Fields added in v0.47.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TopicStatsProjectsLocationsTopicsComputeTimeCursorCall) Header added in v0.47.0

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TopicStatsProjectsLocationsTopicsService added in v0.33.0

type TopicStatsProjectsLocationsTopicsService struct {
	// contains filtered or unexported fields
}

func NewTopicStatsProjectsLocationsTopicsService added in v0.33.0

func NewTopicStatsProjectsLocationsTopicsService(s *Service) *TopicStatsProjectsLocationsTopicsService

func (*TopicStatsProjectsLocationsTopicsService) ComputeHeadCursor added in v0.40.0

ComputeHeadCursor: 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.

- topic: The topic for which we should compute the head cursor.

func (*TopicStatsProjectsLocationsTopicsService) ComputeMessageStats added in v0.33.0

ComputeMessageStats: Compute statistics about a range of messages in a given topic and partition.

- topic: The topic for which we should compute message stats.

func (*TopicStatsProjectsLocationsTopicsService) ComputeTimeCursor added in v0.47.0

ComputeTimeCursor: Compute the corresponding cursor for a publish or event time in a topic partition.

- topic: The topic for which we should compute the cursor.

type TopicStatsProjectsService added in v0.33.0

type TopicStatsProjectsService struct {
	Locations *TopicStatsProjectsLocationsService
	// contains filtered or unexported fields
}

func NewTopicStatsProjectsService added in v0.33.0

func NewTopicStatsProjectsService(s *Service) *TopicStatsProjectsService

type TopicStatsService added in v0.33.0

type TopicStatsService struct {
	Projects *TopicStatsProjectsService
	// contains filtered or unexported fields
}

func NewTopicStatsService added in v0.33.0

func NewTopicStatsService(s *Service) *TopicStatsService

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL