File "Subscriptions.php"
Full Path: /home/u743136113/domains/arvi.seezify.com/public_html/vendor/google/apiclient-services/src/WorkspaceEvents/Resource/Subscriptions.php
File size: 8.89 KB
MIME-type: text/x-php
Charset: utf-8
<?php
/*
* Copyright 2014 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
namespace Google\Service\WorkspaceEvents\Resource;
use Google\Service\WorkspaceEvents\ListSubscriptionsResponse;
use Google\Service\WorkspaceEvents\Operation;
use Google\Service\WorkspaceEvents\ReactivateSubscriptionRequest;
use Google\Service\WorkspaceEvents\Subscription;
/**
* The "subscriptions" collection of methods.
* Typical usage is:
* <code>
* $workspaceeventsService = new Google\Service\WorkspaceEvents(...);
* $subscriptions = $workspaceeventsService->subscriptions;
* </code>
*/
class Subscriptions extends \Google\Service\Resource
{
/**
* [Developer Preview](https://developers.google.com/workspace/preview): Creates
* a Google Workspace subscription. To learn how to use this method, see [Create
* a Google Workspace
* subscription](https://developers.google.com/workspace/events/guides/create-
* subscription). (subscriptions.create)
*
* @param Subscription $postBody
* @param array $optParams Optional parameters.
*
* @opt_param bool validateOnly Optional. If set to `true`, validates and
* previews the request, but doesn't create the subscription.
* @return Operation
* @throws \Google\Service\Exception
*/
public function create(Subscription $postBody, $optParams = [])
{
$params = ['postBody' => $postBody];
$params = array_merge($params, $optParams);
return $this->call('create', [$params], Operation::class);
}
/**
* [Developer Preview](https://developers.google.com/workspace/preview): Deletes
* a Google Workspace subscription. To learn how to use this method, see [Delete
* a Google Workspace
* subscription](https://developers.google.com/workspace/events/guides/delete-
* subscription). (subscriptions.delete)
*
* @param string $name Required. Resource name of the subscription to delete.
* Format: `subscriptions/{subscription}`
* @param array $optParams Optional parameters.
*
* @opt_param bool allowMissing Optional. If set to `true` and the subscription
* isn't found, the request succeeds but doesn't delete the subscription.
* @opt_param string etag Optional. Etag of the subscription. If present, it
* must match with the server's etag. Otherwise, request fails with the status
* `ABORTED`.
* @opt_param bool validateOnly Optional. If set to `true`, validates and
* previews the request, but doesn't delete the subscription.
* @return Operation
* @throws \Google\Service\Exception
*/
public function delete($name, $optParams = [])
{
$params = ['name' => $name];
$params = array_merge($params, $optParams);
return $this->call('delete', [$params], Operation::class);
}
/**
* [Developer Preview](https://developers.google.com/workspace/preview): Gets
* details about a Google Workspace subscription. To learn how to use this
* method, see [Get details about a Google Workspace
* subscription](https://developers.google.com/workspace/events/guides/get-
* subscription). (subscriptions.get)
*
* @param string $name Required. Resource name of the subscription. Format:
* `subscriptions/{subscription}`
* @param array $optParams Optional parameters.
* @return Subscription
* @throws \Google\Service\Exception
*/
public function get($name, $optParams = [])
{
$params = ['name' => $name];
$params = array_merge($params, $optParams);
return $this->call('get', [$params], Subscription::class);
}
/**
* [Developer Preview](https://developers.google.com/workspace/preview): Lists
* Google Workspace subscriptions. To learn how to use this method, see [List
* Google Workspace
* subscriptions](https://developers.google.com/workspace/events/guides/list-
* subscriptions). (subscriptions.listSubscriptions)
*
* @param array $optParams Optional parameters.
*
* @opt_param string filter Required. A query filter. You can filter
* subscriptions by event type (`event_types`) and target resource
* (`target_resource`). You must specify at least one event type in your query.
* To filter for multiple event types, use the `OR` operator. To filter by both
* event type and target resource, use the `AND` operator and specify the full
* resource name, such as `//chat.googleapis.com/spaces/{space}`. For example,
* the following queries are valid: ```
* event_types:"google.workspace.chat.membership.v1.updated" OR
* event_types:"google.workspace.chat.message.v1.created"
* event_types:"google.workspace.chat.message.v1.created" AND
* target_resource="//chat.googleapis.com/spaces/{space}" (
* event_types:"google.workspace.chat.membership.v1.updated" OR
* event_types:"google.workspace.chat.message.v1.created" ) AND
* target_resource="//chat.googleapis.com/spaces/{space}" ``` The server rejects
* invalid queries with an `INVALID_ARGUMENT` error.
* @opt_param int pageSize Optional. The maximum number of subscriptions to
* return. The service might return fewer than this value. If unspecified or set
* to `0`, up to 50 subscriptions are returned. The maximum value is 100. If you
* specify a value more than 100, the system only returns 100 subscriptions.
* @opt_param string pageToken Optional. A page token, received from a previous
* list subscriptions call. Provide this parameter to retrieve the subsequent
* page. When paginating, the filter value should match the call that provided
* the page token. Passing a different value might lead to unexpected results.
* @return ListSubscriptionsResponse
* @throws \Google\Service\Exception
*/
public function listSubscriptions($optParams = [])
{
$params = [];
$params = array_merge($params, $optParams);
return $this->call('list', [$params], ListSubscriptionsResponse::class);
}
/**
* [Developer Preview](https://developers.google.com/workspace/preview): Updates
* or renews a Google Workspace subscription. To learn how to use this method,
* see [Update or renew a Google Workspace
* subscription](https://developers.google.com/workspace/events/guides/update-
* subscription). (subscriptions.patch)
*
* @param string $name Optional. Immutable. Identifier. Resource name of the
* subscription. Format: `subscriptions/{subscription}`
* @param Subscription $postBody
* @param array $optParams Optional parameters.
*
* @opt_param string updateMask Optional. The field to update. If omitted,
* updates any fields included in the request. You can update one of the
* following fields in a subscription: * `expire_time`: The timestamp when the
* subscription expires. * `ttl`: The time-to-live (TTL) or duration of the
* subscription. To fully replace the subscription (the equivalent of `PUT`),
* use `*`. Any omitted fields are updated with empty values.
* @opt_param bool validateOnly Optional. If set to `true`, validates and
* previews the request, but doesn't update the subscription.
* @return Operation
* @throws \Google\Service\Exception
*/
public function patch($name, Subscription $postBody, $optParams = [])
{
$params = ['name' => $name, 'postBody' => $postBody];
$params = array_merge($params, $optParams);
return $this->call('patch', [$params], Operation::class);
}
/**
* [Developer Preview](https://developers.google.com/workspace/preview):
* Reactivates a suspended Google Workspace subscription. This method resets
* your subscription's `State` field to `ACTIVE`. Before you use this method,
* you must fix the error that suspended the subscription. To learn how to use
* this method, see [Reactivate a Google Workspace subscription](https://develop
* ers.google.com/workspace/events/guides/reactivate-subscription).
* (subscriptions.reactivate)
*
* @param string $name Required. Resource name of the subscription. Format:
* `subscriptions/{subscription}`
* @param ReactivateSubscriptionRequest $postBody
* @param array $optParams Optional parameters.
* @return Operation
* @throws \Google\Service\Exception
*/
public function reactivate($name, ReactivateSubscriptionRequest $postBody, $optParams = [])
{
$params = ['name' => $name, 'postBody' => $postBody];
$params = array_merge($params, $optParams);
return $this->call('reactivate', [$params], Operation::class);
}
}
// Adding a class alias for backwards compatibility with the previous class name.
class_alias(Subscriptions::class, 'Google_Service_WorkspaceEvents_Resource_Subscriptions');