GoogleApi.WorkspaceEvents.V1.Model.Subscription (google_api_workspace_events v0.4.1)
View SourceDeveloper Preview. A subscription to receive events about a Google Workspace resource. To learn more about subscriptions, see the Google Workspace Events API overview.
Attributes
-
authority
(type:String.t
, default:nil
) - Output only. The user who authorized the creation of the subscription. Format:users/{user}
For Google Workspace users, the{user}
value is theuser.id
field from the Directory API. -
createTime
(type:DateTime.t
, default:nil
) - Output only. The time when the subscription is created. -
etag
(type:String.t
, default:nil
) - Optional. This checksum is computed by the server based on the value of other fields, and might be sent on update requests to ensure the client has an up-to-date value before proceeding. -
eventTypes
(type:list(String.t)
, default:nil
) - Required. Unordered list. Input for creating a subscription. Otherwise, output only. One or more types of events to receive about the target resource. Formatted according to the CloudEvents specification. The supported event types depend on the target resource of your subscription. For details, see Supported Google Workspace events. By default, you also receive events about the lifecycle of your subscription. You don't need to specify lifecycle events for this field. If you specify an event type that doesn't exist for the target resource, the request returns an HTTP400 Bad Request
status code. -
expireTime
(type:DateTime.t
, default:nil
) - Non-empty default. The timestamp in UTC when the subscription expires. Always displayed on output, regardless of what was used on input. -
name
(type:String.t
, default:nil
) - Identifier. Resource name of the subscription. Format:subscriptions/{subscription}
-
notificationEndpoint
(type:GoogleApi.WorkspaceEvents.V1.Model.NotificationEndpoint.t
, default:nil
) - Required. Immutable. The endpoint where the subscription delivers events, such as a Pub/Sub topic. -
payloadOptions
(type:GoogleApi.WorkspaceEvents.V1.Model.PayloadOptions.t
, default:nil
) - Optional. Options about what data to include in the event payload. Only supported for Google Chat events. -
reconciling
(type:boolean()
, default:nil
) - Output only. Iftrue
, the subscription is in the process of being updated. -
state
(type:String.t
, default:nil
) - Output only. The state of the subscription. Determines whether the subscription can receive events and deliver them to the notification endpoint. -
suspensionReason
(type:String.t
, default:nil
) - Output only. The error that suspended the subscription. To reactivate the subscription, resolve the error and call theReactivateSubscription
method. -
targetResource
(type:String.t
, default:nil
) - Required. Immutable. The Google Workspace resource that's monitored for events, formatted as the full resource name. To learn about target resources and the events that they support, see Supported Google Workspace events. A user can only authorize your app to create one subscription for a given target resource. If your app tries to create another subscription with the same user credentials, the request returns anALREADY_EXISTS
error. -
ttl
(type:String.t
, default:nil
) - Input only. The time-to-live (TTL) or duration for the subscription. If unspecified or set to0
, uses the maximum possible duration. -
uid
(type:String.t
, default:nil
) - Output only. System-assigned unique identifier for the subscription. -
updateTime
(type:DateTime.t
, default:nil
) - Output only. The last time that the subscription is updated.
Summary
Functions
Unwrap a decoded JSON object into its complex fields.
Types
@type t() :: %GoogleApi.WorkspaceEvents.V1.Model.Subscription{ authority: String.t() | nil, createTime: DateTime.t() | nil, etag: String.t() | nil, eventTypes: [String.t()] | nil, expireTime: DateTime.t() | nil, name: String.t() | nil, notificationEndpoint: GoogleApi.WorkspaceEvents.V1.Model.NotificationEndpoint.t() | nil, payloadOptions: GoogleApi.WorkspaceEvents.V1.Model.PayloadOptions.t() | nil, reconciling: boolean() | nil, state: String.t() | nil, suspensionReason: String.t() | nil, targetResource: String.t() | nil, ttl: String.t() | nil, uid: String.t() | nil, updateTime: DateTime.t() | nil }