* $androidpublisherService = new Google\Service\AndroidPublisher(...); * $subscriptions = $androidpublisherService->monetization_subscriptions; * */ class MonetizationSubscriptions extends \Google\Service\Resource { /** * Deprecated: subscription archiving is not supported. (subscriptions.archive) * * @param string $packageName Required. The parent app (package name) of the app * of the subscription to delete. * @param string $productId Required. The unique product ID of the subscription * to delete. * @param ArchiveSubscriptionRequest $postBody * @param array $optParams Optional parameters. * @return Subscription * @throws \Google\Service\Exception */ public function archive($packageName, $productId, ArchiveSubscriptionRequest $postBody, $optParams = []) { $params = ['packageName' => $packageName, 'productId' => $productId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('archive', [$params], Subscription::class); } /** * Reads one or more subscriptions. (subscriptions.batchGet) * * @param string $packageName Required. The parent app (package name) for which * the subscriptions should be retrieved. Must be equal to the package_name * field on all the requests. * @param array $optParams Optional parameters. * * @opt_param string productIds Required. A list of up to 100 subscription * product IDs to retrieve. All the IDs must be different. * @return BatchGetSubscriptionsResponse * @throws \Google\Service\Exception */ public function batchGet($packageName, $optParams = []) { $params = ['packageName' => $packageName]; $params = array_merge($params, $optParams); return $this->call('batchGet', [$params], BatchGetSubscriptionsResponse::class); } /** * Updates a batch of subscriptions. Set the latencyTolerance field on nested * requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve * maximum update throughput. (subscriptions.batchUpdate) * * @param string $packageName Required. The parent app (package name) for which * the subscriptions should be updated. Must be equal to the package_name field * on all the Subscription resources. * @param BatchUpdateSubscriptionsRequest $postBody * @param array $optParams Optional parameters. * @return BatchUpdateSubscriptionsResponse * @throws \Google\Service\Exception */ public function batchUpdate($packageName, BatchUpdateSubscriptionsRequest $postBody, $optParams = []) { $params = ['packageName' => $packageName, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('batchUpdate', [$params], BatchUpdateSubscriptionsResponse::class); } /** * Creates a new subscription. Newly added base plans will remain in draft state * until activated. (subscriptions.create) * * @param string $packageName Required. The parent app (package name) for which * the subscription should be created. Must be equal to the package_name field * on the Subscription resource. * @param Subscription $postBody * @param array $optParams Optional parameters. * * @opt_param string productId Required. The ID to use for the subscription. For * the requirements on this format, see the documentation of the product_id * field on the Subscription resource. * @opt_param string regionsVersion.version Required. A string representing the * version of available regions being used for the specified resource. Regional * prices for the resource have to be specified according to the information * published in [this article](https://support.google.com/googleplay/android- * developer/answer/10532353). Each time the supported locations substantially * change, the version will be incremented. Using this field will ensure that * creating and updating the resource with an older region's version and set of * regional prices and currencies will succeed even though a new version is * available. The latest version is 2022/02. * @return Subscription * @throws \Google\Service\Exception */ public function create($packageName, Subscription $postBody, $optParams = []) { $params = ['packageName' => $packageName, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('create', [$params], Subscription::class); } /** * Deletes a subscription. A subscription can only be deleted if it has never * had a base plan published. (subscriptions.delete) * * @param string $packageName Required. The parent app (package name) of the app * of the subscription to delete. * @param string $productId Required. The unique product ID of the subscription * to delete. * @param array $optParams Optional parameters. * @throws \Google\Service\Exception */ public function delete($packageName, $productId, $optParams = []) { $params = ['packageName' => $packageName, 'productId' => $productId]; $params = array_merge($params, $optParams); return $this->call('delete', [$params]); } /** * Reads a single subscription. (subscriptions.get) * * @param string $packageName Required. The parent app (package name) of the * subscription to get. * @param string $productId Required. The unique product ID of the subscription * to get. * @param array $optParams Optional parameters. * @return Subscription * @throws \Google\Service\Exception */ public function get($packageName, $productId, $optParams = []) { $params = ['packageName' => $packageName, 'productId' => $productId]; $params = array_merge($params, $optParams); return $this->call('get', [$params], Subscription::class); } /** * Lists all subscriptions under a given app. * (subscriptions.listMonetizationSubscriptions) * * @param string $packageName Required. The parent app (package name) for which * the subscriptions should be read. * @param array $optParams Optional parameters. * * @opt_param int pageSize The maximum number of subscriptions to return. The * service may return fewer than this value. If unspecified, at most 50 * subscriptions will be returned. The maximum value is 1000; values above 1000 * will be coerced to 1000. * @opt_param string 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. * @opt_param bool showArchived Deprecated: subscription archiving is not * supported. * @return ListSubscriptionsResponse * @throws \Google\Service\Exception */ public function listMonetizationSubscriptions($packageName, $optParams = []) { $params = ['packageName' => $packageName]; $params = array_merge($params, $optParams); return $this->call('list', [$params], ListSubscriptionsResponse::class); } /** * Updates an existing subscription. (subscriptions.patch) * * @param string $packageName Immutable. Package name of the parent app. * @param string $productId Immutable. Unique product ID of the product. Unique * within the parent app. Product IDs must be composed of lower-case letters * (a-z), numbers (0-9), underscores (_) and dots (.). It must start with a * lower-case letter or number, and be between 1 and 40 (inclusive) characters * in length. * @param Subscription $postBody * @param array $optParams Optional parameters. * * @opt_param bool allowMissing Optional. If set to true, and the subscription * with the given package_name and product_id doesn't exist, the subscription * will be created. If a new subscription is created, update_mask is ignored. * @opt_param string latencyTolerance Optional. The latency tolerance for the * propagation of this product update. Defaults to latency-sensitive. * @opt_param string regionsVersion.version Required. A string representing the * version of available regions being used for the specified resource. Regional * prices for the resource have to be specified according to the information * published in [this article](https://support.google.com/googleplay/android- * developer/answer/10532353). Each time the supported locations substantially * change, the version will be incremented. Using this field will ensure that * creating and updating the resource with an older region's version and set of * regional prices and currencies will succeed even though a new version is * available. The latest version is 2022/02. * @opt_param string updateMask Required. The list of fields to be updated. * @return Subscription * @throws \Google\Service\Exception */ public function patch($packageName, $productId, Subscription $postBody, $optParams = []) { $params = ['packageName' => $packageName, 'productId' => $productId, 'postBody' => $postBody]; $params = array_merge($params, $optParams); return $this->call('patch', [$params], Subscription::class); } } // Adding a class alias for backwards compatibility with the previous class name. class_alias(MonetizationSubscriptions::class, 'Google_Service_AndroidPublisher_Resource_MonetizationSubscriptions');