feat(paymentsresellersubscription): update the api

#### paymentsresellersubscription:v1 The following keys were deleted: - schemas.GoogleCloudPaymentsResellerSubscriptionV1Product.properties.name.readOnly (Total Keys: 1) - schemas.GoogleCloudPaymentsResellerSubscriptionV1Promotion.properties.name.readOnly (Total Keys: 1) The following keys were added: - schemas.GoogleCloudPaymentsResellerSubscriptionV1PromotionIntroductoryPricingDetails.properties.introductoryPricingSpecs.readOnly (Total Keys: 1) - schemas.GoogleCloudPaymentsResellerSubscriptionV1SubscriptionCancellationDetails.properties.reason.readOnly (Total Keys: 1) - schemas.GoogleCloudPaymentsResellerSubscriptionV1SubscriptionLineItemOneTimeRecurrenceDetails.properties.servicePeriod.readOnly (Total Keys: 1) - schemas.SubscriptionLineItemBundleDetails.properties.bundleElementDetails.readOnly (Total Keys: 1)
googleapis · Feb 27, 2024 · ba12c71 · ba12c71
1 parent 36d096e
commit ba12c71
Show file tree

Hide file tree

Showing 4 changed files with 87 additions and 78 deletions.
diff --git a/docs/dyn/paymentsresellersubscription_v1.partners.products.html b/docs/dyn/paymentsresellersubscription_v1.partners.products.html
@@ -95,7 +95,7 @@ <h3>Method Details</h3>
 
 Args:
   parent: string, Required. The parent, the partner that can resell. Format: partners/{partner} (required)
-  filter: string, Optional. Specifies the filters for the product results. The syntax is defined in https://google.aip.dev/160 with the following caveats: - Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) - Only the following fields are supported: - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` - Unless explicitly mentioned above, other features are not supported. Example: `regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
+  filter: string, Optional. Specifies the filters for the product results. The syntax is defined in https://google.aip.dev/160 with the following caveats: 1. Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) 2. Only the following fields are supported: - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` 3. Unless explicitly mentioned above, other features are not supported. Example: `regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
   pageSize: integer, Optional. The maximum number of products to return. The service may return fewer than this value. If unspecified, at most 50 products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
   pageToken: string, Optional. A page token, received from a previous `ListProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListProducts` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
@@ -106,7 +106,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    {
+    { # Response that contains the products.
   &quot;nextPageToken&quot;: &quot;A String&quot;, # A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.
   &quot;products&quot;: [ # The products for the specified partner.
     { # A Product resource that defines a subscription service that can be resold.
@@ -121,7 +121,7 @@ <h3>Method Details</h3>
       &quot;finiteBillingCycleDetails&quot;: { # Details for a subscriptiin line item with finite billing cycles. # Optional. Details for a subscription line item with finite billing cycles. If unset, the line item will be charged indefinitely.
         &quot;billingCycleCountLimit&quot;: &quot;A String&quot;, # Required. The number of a subscription line item billing cycles after which billing will stop automatically.
       },
-      &quot;name&quot;: &quot;A String&quot;, # Output only. Response only. Resource name of the product. It will have the format of &quot;partners/{partner_id}/products/{product_id}&quot;
+      &quot;name&quot;: &quot;A String&quot;, # Identifier. Response only. Resource name of the product. It will have the format of &quot;partners/{partner_id}/products/{product_id}&quot;
       &quot;priceConfigs&quot;: [ # Output only. Price configs for the product in the available regions.
         { # Configs the prices in an available region.
           &quot;amount&quot;: { # Describes the amount unit including the currency code. # Output only. The price in the region.

diff --git a/docs/dyn/paymentsresellersubscription_v1.partners.promotions.html b/docs/dyn/paymentsresellersubscription_v1.partners.promotions.html
@@ -104,8 +104,8 @@ <h3>Method Details</h3>
   body: object, The request body.
     The object takes the form of:
 
-{
-  &quot;filter&quot;: &quot;A String&quot;, # Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: - Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) - Only the following fields are supported: - `applicableProducts` - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` - Unless explicitly mentioned above, other features are not supported. Example: `applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
+{ # Request to find eligible promotions for the current user.
+  &quot;filter&quot;: &quot;A String&quot;, # Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: 1. Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) 2. Only the following fields are supported: - `applicableProducts` - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` 3. Unless explicitly mentioned above, other features are not supported. Example: `applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
   &quot;pageSize&quot;: 42, # Optional. The maximum number of promotions to return. The service may return fewer than this value. If unspecified, at most 50 products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
   &quot;pageToken&quot;: &quot;A String&quot;, # Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.
 }
@@ -131,7 +131,7 @@ <h3>Method Details</h3>
         &quot;unit&quot;: &quot;A String&quot;, # The unit used for the duration
       },
       &quot;introductoryPricingDetails&quot;: { # The details of a introductory pricing promotion. # Optional. Specifies the introductory pricing details when the promotion_type is PROMOTION_TYPE_INTRODUCTORY_PRICING.
-        &quot;introductoryPricingSpecs&quot;: [ # Specifies the introductory pricing periods.
+        &quot;introductoryPricingSpecs&quot;: [ # Output only. Specifies the introductory pricing periods.
           { # The duration of an introductory pricing promotion.
             &quot;discountAmount&quot;: { # Describes the amount unit including the currency code. # Output only. The discount amount. The value is positive.
               &quot;amountMicros&quot;: &quot;A String&quot;, # Required. Amount in micros (1_000_000 micros = 1 currency unit)
@@ -143,7 +143,7 @@ <h3>Method Details</h3>
           },
         ],
       },
-      &quot;name&quot;: &quot;A String&quot;, # Output only. Response only. Resource name of the subscription promotion. It will have the format of &quot;partners/{partner_id}/promotion/{promotion_id}&quot;
+      &quot;name&quot;: &quot;A String&quot;, # Identifier. Response only. Resource name of the subscription promotion. It will have the format of &quot;partners/{partner_id}/promotion/{promotion_id}&quot;
       &quot;promotionType&quot;: &quot;A String&quot;, # Output only. Output Only. Specifies the type of the promotion.
       &quot;regionCodes&quot;: [ # Output only. 2-letter ISO region code where the promotion is available in. Ex. &quot;US&quot; Please refers to: https://en.wikipedia.org/wiki/ISO_3166-1
         &quot;A String&quot;,
@@ -180,7 +180,7 @@ <h3>Method Details</h3>
 
 Args:
   parent: string, Required. The parent, the partner that can resell. Format: partners/{partner} (required)
-  filter: string, Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: - Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) - Only the following fields are supported: - `applicableProducts` - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` - Unless explicitly mentioned above, other features are not supported. Example: `applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
+  filter: string, Optional. Specifies the filters for the promotion results. The syntax is defined in https://google.aip.dev/160 with the following caveats: 1. Only the following features are supported: - Logical operator `AND` - Comparison operator `=` (no wildcards `*`) - Traversal operator `.` - Has operator `:` (no wildcards `*`) 2. Only the following fields are supported: - `applicableProducts` - `regionCodes` - `youtubePayload.partnerEligibilityId` - `youtubePayload.postalCode` 3. Unless explicitly mentioned above, other features are not supported. Example: `applicableProducts:partners/partner1/products/product1 AND regionCodes:US AND youtubePayload.postalCode=94043 AND youtubePayload.partnerEligibilityId=eligibility-id`
   pageSize: integer, Optional. The maximum number of promotions to return. The service may return fewer than this value. If unspecified, at most 50 products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
   pageToken: string, Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
@@ -191,7 +191,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    {
+    { # Response that contains the promotions.
   &quot;nextPageToken&quot;: &quot;A String&quot;, # A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.
   &quot;promotions&quot;: [ # The promotions for the specified partner.
     { # A Promotion resource that defines a promotion for a subscription that can be resold.
@@ -204,7 +204,7 @@ <h3>Method Details</h3>
         &quot;unit&quot;: &quot;A String&quot;, # The unit used for the duration
       },
       &quot;introductoryPricingDetails&quot;: { # The details of a introductory pricing promotion. # Optional. Specifies the introductory pricing details when the promotion_type is PROMOTION_TYPE_INTRODUCTORY_PRICING.
-        &quot;introductoryPricingSpecs&quot;: [ # Specifies the introductory pricing periods.
+        &quot;introductoryPricingSpecs&quot;: [ # Output only. Specifies the introductory pricing periods.
           { # The duration of an introductory pricing promotion.
             &quot;discountAmount&quot;: { # Describes the amount unit including the currency code. # Output only. The discount amount. The value is positive.
               &quot;amountMicros&quot;: &quot;A String&quot;, # Required. Amount in micros (1_000_000 micros = 1 currency unit)
@@ -216,7 +216,7 @@ <h3>Method Details</h3>
           },
         ],
       },
-      &quot;name&quot;: &quot;A String&quot;, # Output only. Response only. Resource name of the subscription promotion. It will have the format of &quot;partners/{partner_id}/promotion/{promotion_id}&quot;
+      &quot;name&quot;: &quot;A String&quot;, # Identifier. Response only. Resource name of the subscription promotion. It will have the format of &quot;partners/{partner_id}/promotion/{promotion_id}&quot;
       &quot;promotionType&quot;: &quot;A String&quot;, # Output only. Output Only. Specifies the type of the promotion.
       &quot;regionCodes&quot;: [ # Output only. 2-letter ISO region code where the promotion is available in. Ex. &quot;US&quot; Please refers to: https://en.wikipedia.org/wiki/ISO_3166-1
         &quot;A String&quot;,