Google Workspace Add-ons V1 Client - Class GSuiteAddOnsClient (1.0.1)

Namespace

Methods

__construct

createDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\CreateDeploymentRequest;
use Google\Cloud\GSuiteAddOns\V1\Deployment;

/**
 * @param string $formattedParent Name of the project in which to create the deployment.
 *
 *                                Example: `projects/my_project`. Please see
 *                                {@see GSuiteAddOnsClient::projectName()} for help formatting this field.
 * @param string $deploymentId    The id to use for this deployment.  The full name of the created
 *                                resource will be `projects/<project_number>/deployments/<deployment_id>`.
 */
function create_deployment_sample(string $formattedParent, string $deploymentId): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $deployment = new Deployment();
    $request = (new CreateDeploymentRequest())
        ->setParent($formattedParent)
        ->setDeploymentId($deploymentId)
        ->setDeployment($deployment);

    // Call the API and handle any network failures.
    try {
        /** @var Deployment $response */
        $response = $gSuiteAddOnsClient->createDeployment($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = GSuiteAddOnsClient::projectName('[PROJECT]');
    $deploymentId = '[DEPLOYMENT_ID]';

    create_deployment_sample($formattedParent, $deploymentId);
}

deleteDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\DeleteDeploymentRequest;

/**
 * @param string $formattedName The full resource name of the deployment to delete.
 *
 *                              Example:  `projects/my_project/deployments/my_deployment`. Please see
 *                              {@see GSuiteAddOnsClient::deploymentName()} for help formatting this field.
 */
function delete_deployment_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new DeleteDeploymentRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        $gSuiteAddOnsClient->deleteDeployment($request);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::deploymentName('[PROJECT]', '[DEPLOYMENT]');

    delete_deployment_sample($formattedName);
}

getAuthorization

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Authorization;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\GetAuthorizationRequest;

/**
 * @param string $formattedName Name of the project for which to get the Google Workspace Add-ons
 *                              authorization information.
 *
 *                              Example: `projects/my_project/authorization`. Please see
 *                              {@see GSuiteAddOnsClient::authorizationName()} for help formatting this field.
 */
function get_authorization_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new GetAuthorizationRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var Authorization $response */
        $response = $gSuiteAddOnsClient->getAuthorization($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::authorizationName('[PROJECT]');

    get_authorization_sample($formattedName);
}

getDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\Deployment;
use Google\Cloud\GSuiteAddOns\V1\GetDeploymentRequest;

/**
 * @param string $formattedName The full resource name of the deployment to get.
 *
 *                              Example:  `projects/my_project/deployments/my_deployment`. Please see
 *                              {@see GSuiteAddOnsClient::deploymentName()} for help formatting this field.
 */
function get_deployment_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new GetDeploymentRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var Deployment $response */
        $response = $gSuiteAddOnsClient->getDeployment($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::deploymentName('[PROJECT]', '[DEPLOYMENT]');

    get_deployment_sample($formattedName);
}

getInstallStatus

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\GetInstallStatusRequest;
use Google\Cloud\GSuiteAddOns\V1\InstallStatus;

/**
 * @param string $formattedName The full resource name of the deployment.
 *
 *                              Example:  `projects/my_project/deployments/my_deployment/installStatus`. Please see
 *                              {@see GSuiteAddOnsClient::installStatusName()} for help formatting this field.
 */
function get_install_status_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new GetInstallStatusRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var InstallStatus $response */
        $response = $gSuiteAddOnsClient->getInstallStatus($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::installStatusName('[PROJECT]', '[DEPLOYMENT]');

    get_install_status_sample($formattedName);
}

installDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\InstallDeploymentRequest;

/**
 * @param string $formattedName The full resource name of the deployment to install.
 *
 *                              Example:  `projects/my_project/deployments/my_deployment`. Please see
 *                              {@see GSuiteAddOnsClient::deploymentName()} for help formatting this field.
 */
function install_deployment_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new InstallDeploymentRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        $gSuiteAddOnsClient->installDeployment($request);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::deploymentName('[PROJECT]', '[DEPLOYMENT]');

    install_deployment_sample($formattedName);
}

listDeployments

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\Deployment;
use Google\Cloud\GSuiteAddOns\V1\ListDeploymentsRequest;

/**
 * @param string $formattedParent Name of the project in which to create the deployment.
 *
 *                                Example: `projects/my_project`. Please see
 *                                {@see GSuiteAddOnsClient::projectName()} for help formatting this field.
 */
function list_deployments_sample(string $formattedParent): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new ListDeploymentsRequest())
        ->setParent($formattedParent);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $gSuiteAddOnsClient->listDeployments($request);

        /** @var Deployment $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = GSuiteAddOnsClient::projectName('[PROJECT]');

    list_deployments_sample($formattedParent);
}

replaceDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\Deployment;
use Google\Cloud\GSuiteAddOns\V1\ReplaceDeploymentRequest;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function replace_deployment_sample(): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $deployment = new Deployment();
    $request = (new ReplaceDeploymentRequest())
        ->setDeployment($deployment);

    // Call the API and handle any network failures.
    try {
        /** @var Deployment $response */
        $response = $gSuiteAddOnsClient->replaceDeployment($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

uninstallDeployment

use Google\ApiCore\ApiException;
use Google\Cloud\GSuiteAddOns\V1\Client\GSuiteAddOnsClient;
use Google\Cloud\GSuiteAddOns\V1\UninstallDeploymentRequest;

/**
 * @param string $formattedName The full resource name of the deployment to install.
 *
 *                              Example:  `projects/my_project/deployments/my_deployment`. Please see
 *                              {@see GSuiteAddOnsClient::deploymentName()} for help formatting this field.
 */
function uninstall_deployment_sample(string $formattedName): void
{
    // Create a client.
    $gSuiteAddOnsClient = new GSuiteAddOnsClient();

    // Prepare the request message.
    $request = (new UninstallDeploymentRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        $gSuiteAddOnsClient->uninstallDeployment($request);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = GSuiteAddOnsClient::deploymentName('[PROJECT]', '[DEPLOYMENT]');

    uninstall_deployment_sample($formattedName);
}

createDeploymentAsync

deleteDeploymentAsync

getAuthorizationAsync

getDeploymentAsync

getInstallStatusAsync

installDeploymentAsync

listDeploymentsAsync

replaceDeploymentAsync

uninstallDeploymentAsync

static::authorizationName

static::deploymentName

static::installStatusName

static::projectName

static::parseName