Hi there! Are you looking for the official Deno documentation? Try docs.deno.com for all your Deno learning needs.

GoogleCloudPaymentsResellerSubscriptionV1Subscription

import type { GoogleCloudPaymentsResellerSubscriptionV1Subscription } from "https://googleapis.deno.dev/v1/paymentsresellersubscription:v1.ts";

A subscription serves as a central billing entity between an external partner and Google. The underlying Google services rely on the subscription state to grant or revoke the user's service entitlement. It's important to note that the subscription state may not always perfectly align with the user's service entitlement. For example, some Google services may continue providing access to the user until the current billing cycle ends, even if the subscription has been immediately canceled. However, other services may not do the same. To fully understand the specific details, please consult the relevant contract or product policy.

interface GoogleCloudPaymentsResellerSubscriptionV1Subscription {

readonly cancellationDetails?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails;

readonly createTime?: Date;

readonly cycleEndTime?: Date;

readonly endUserEntitled?: boolean;

readonly freeTrialEndTime?: Date;

lineItems?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem[];

name?: string;

partnerUserToken?: string;

readonly processingState?: "PROCESSING_STATE_UNSPECIFIED" | "PROCESSING_STATE_CANCELLING" | "PROCESSING_STATE_RECURRING";

products?: string[];

promotions?: string[];

promotionSpecs?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec[];

purchaseTime?: Date;

readonly redirectUri?: string;

readonly renewalTime?: Date;

serviceLocation?: GoogleCloudPaymentsResellerSubscriptionV1Location;

readonly state?:

| "STATE_UNSPECIFIED"

| "STATE_CREATED"

| "STATE_ACTIVE"

| "STATE_CANCELLED"

| "STATE_IN_GRACE_PERIOD"

| "STATE_CANCEL_AT_END_OF_CYCLE"

| "STATE_SUSPENDED";

readonly updateTime?: Date;

upgradeDowngradeDetails?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionUpgradeDowngradeDetails;

}

§Properties

readonly cancellationDetails?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails

Output only. Describes the details of a cancelled subscription. Only applicable to subscription of state STATE_CANCELLED.

readonly createTime?: Date

Output only. System generated timestamp when the subscription is created. UTC timezone.

readonly cycleEndTime?: Date

Output only. The time at which the subscription is expected to be extended, in ISO 8061 format. UTC timezone. For example: "2019-08-31T17:28:54.564Z"

readonly endUserEntitled?: boolean

Output only. Indicates if the subscription is entitled to the end user.

readonly freeTrialEndTime?: Date

Output only. End of the free trial period, in ISO 8061 format. For example, "2019-08-31T17:28:54.564Z". It will be set the same as createTime if no free trial promotion is specified.

lineItems?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItem[]

Required. The line items of the subscription.

name?: string

Identifier. Resource name of the subscription. It will have the format of "partners/{partner_id}/subscriptions/{subscription_id}". This is available for authorizeAddon, but otherwise is response only.

partnerUserToken?: string

Required. Identifier of the end-user in partner’s system. The value is restricted to 63 ASCII characters at the maximum.

readonly processingState?: "PROCESSING_STATE_UNSPECIFIED" | "PROCESSING_STATE_CANCELLING" | "PROCESSING_STATE_RECURRING"

Output only. Describes the processing state of the subscription. See more details at the lifecycle of a subscription.

products?: string[]

Optional. Deprecated: consider using line_items as the input. Required. Resource name that identifies the purchased products. The format will be 'partners/{partner_id}/products/{product_id}'.

promotions?: string[]

Optional. Deprecated: consider using the top-level promotion_specs as the input. Optional. Resource name that identifies one or more promotions that can be applied on the product. A typical promotion for a subscription is Free trial. The format will be 'partners/{partner_id}/promotions/{promotion_id}'.

promotionSpecs?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionPromotionSpec[]

Optional. Subscription-level promotions. Only free trial is supported on this level. It determines the first renewal time of the subscription to be the end of the free trial period. Specify the promotion resource name only when used as input.

purchaseTime?: Date

Optional. The timestamp when the user transaction was made with the Partner. Specify for the case of "bundle with choice", and it must be before the provision_time (when the user makes a selection).

readonly redirectUri?: string

Output only. The place where partners should redirect the end-user to after creation. This field might also be populated when creation failed. However, Partners should always prepare a default URL to redirect the user in case this field is empty.

readonly renewalTime?: Date

Output only. The time at which the subscription is expected to be renewed by Google - a new charge will be incurred and the service entitlement will be renewed. A non-immediate cancellation will take place at this time too, before which, the service entitlement for the end user will remain valid. UTC timezone in ISO 8061 format. For example: "2019-08-31T17:28:54.564Z"

serviceLocation?: GoogleCloudPaymentsResellerSubscriptionV1Location

Required. The location that the service is provided as indicated by the partner.

readonly state?: "STATE_UNSPECIFIED" | "STATE_CREATED" | "STATE_ACTIVE" | "STATE_CANCELLED" | "STATE_IN_GRACE_PERIOD" | "STATE_CANCEL_AT_END_OF_CYCLE" | "STATE_SUSPENDED"

Output only. Describes the state of the subscription. See more details at the lifecycle of a subscription.

readonly updateTime?: Date

Output only. System generated timestamp when the subscription is most recently updated. UTC timezone.

upgradeDowngradeDetails?: GoogleCloudPaymentsResellerSubscriptionV1SubscriptionUpgradeDowngradeDetails

Optional. Details about the previous subscription that this new subscription upgrades/downgrades from. Only populated if this subscription is an upgrade/downgrade from another subscription.