Google Cloud Api Hub V1 Client - Class ApiHubCollectClient (0.3.0)

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\ApiHub\V1\ApiData;
use Google\Cloud\ApiHub\V1\Client\ApiHubCollectClient;
use Google\Cloud\ApiHub\V1\CollectApiDataRequest;
use Google\Cloud\ApiHub\V1\CollectApiDataResponse;
use Google\Cloud\ApiHub\V1\CollectionType;
use Google\Rpc\Status;

/**
 * @param string $formattedLocation       The regional location of the API hub instance and its resources.
 *                                        Format: `projects/{project}/locations/{location}`
 *                                        Please see {@see ApiHubCollectClient::locationName()} for help formatting this field.
 * @param int    $collectionType          The type of collection. Applies to all entries in
 *                                        [api_data][google.cloud.apihub.v1.CollectApiDataRequest.api_data].
 * @param string $formattedPluginInstance The plugin instance collecting the API data.
 *                                        Format:
 *                                        `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`. Please see
 *                                        {@see ApiHubCollectClient::pluginInstanceName()} for help formatting this field.
 * @param string $actionId                The action ID to be used for collecting the API data.
 *                                        This should map to one of the action IDs specified
 *                                        in action configs in the plugin.
 */
function collect_api_data_sample(
    string $formattedLocation,
    int $collectionType,
    string $formattedPluginInstance,
    string $actionId
): void {
    // Create a client.
    $apiHubCollectClient = new ApiHubCollectClient();

    // Prepare the request message.
    $apiData = new ApiData();
    $request = (new CollectApiDataRequest())
        ->setLocation($formattedLocation)
        ->setCollectionType($collectionType)
        ->setPluginInstance($formattedPluginInstance)
        ->setActionId($actionId)
        ->setApiData($apiData);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $apiHubCollectClient->collectApiData($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            /** @var CollectApiDataResponse $result */
            $result = $response->getResult();
            printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->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
{
    $formattedLocation = ApiHubCollectClient::locationName('[PROJECT]', '[LOCATION]');
    $collectionType = CollectionType::COLLECTION_TYPE_UNSPECIFIED;
    $formattedPluginInstance = ApiHubCollectClient::pluginInstanceName(
        '[PROJECT]',
        '[LOCATION]',
        '[PLUGIN]',
        '[INSTANCE]'
    );
    $actionId = '[ACTION_ID]';

    collect_api_data_sample($formattedLocation, $collectionType, $formattedPluginInstance, $actionId);
}

use Google\ApiCore\ApiException;
use Google\Cloud\ApiHub\V1\Client\ApiHubCollectClient;
use Google\Cloud\Location\GetLocationRequest;
use Google\Cloud\Location\Location;

/**
 * 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 get_location_sample(): void
{
    // Create a client.
    $apiHubCollectClient = new ApiHubCollectClient();

    // Prepare the request message.
    $request = new GetLocationRequest();

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

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\ApiHub\V1\Client\ApiHubCollectClient;
use Google\Cloud\Location\ListLocationsRequest;

/**
 * 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 list_locations_sample(): void
{
    // Create a client.
    $apiHubCollectClient = new ApiHubCollectClient();

    // Prepare the request message.
    $request = new ListLocationsRequest();

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

        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());
    }
}