Google Ads Ad Manager V1 Client - Class PartnerServiceClient (0.14.1)

use Google\Ads\AdManager\V1\BatchUpdatePartnersRequest;
use Google\Ads\AdManager\V1\BatchUpdatePartnersResponse;
use Google\Ads\AdManager\V1\Client\PartnerServiceClient;
use Google\Ads\AdManager\V1\Partner;
use Google\Ads\AdManager\V1\UpdatePartnerRequest;
use Google\ApiCore\ApiException;

/**
 * @param string $formattedParent            The parent resource where
 *                                           [Partner][google.ads.admanager.v1.Partner]s will be updated. Format:
 *                                           `networks/{network_code}` The parent field in the
 *                                           [UpdatePartnerRequest][google.ads.admanager.v1.UpdatePartnerRequest] must
 *                                           match this field. Please see
 *                                           {@see PartnerServiceClient::networkName()} for help formatting this field.
 * @param string $requestsPartnerDisplayName The display name of the
 *                                           [Partner][google.ads.admanager.v1.Partner].
 */
function batch_update_partners_sample(
    string $formattedParent,
    string $requestsPartnerDisplayName
): void {
    // Create a client.
    $partnerServiceClient = new PartnerServiceClient();

    // Prepare the request message.
    $requestsPartner = (new Partner())
        ->setDisplayName($requestsPartnerDisplayName);
    $updatePartnerRequest = (new UpdatePartnerRequest())
        ->setPartner($requestsPartner);
    $requests = [$updatePartnerRequest,];
    $request = (new BatchUpdatePartnersRequest())
        ->setParent($formattedParent)
        ->setRequests($requests);

    // Call the API and handle any network failures.
    try {
        /** @var BatchUpdatePartnersResponse $response */
        $response = $partnerServiceClient->batchUpdatePartners($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 = PartnerServiceClient::networkName('[NETWORK_CODE]');
    $requestsPartnerDisplayName = '[DISPLAY_NAME]';

    batch_update_partners_sample($formattedParent, $requestsPartnerDisplayName);
}

use Google\Ads\AdManager\V1\Client\PartnerServiceClient;
use Google\Ads\AdManager\V1\GetPartnerRequest;
use Google\Ads\AdManager\V1\Partner;
use Google\ApiCore\ApiException;

/**
 * @param string $formattedName The resource name of the
 *                              [Partner][google.ads.admanager.v1.Partner]. Format:
 *                              `networks/{network_code}/partners/{partner_id}`
 *                              Please see {@see PartnerServiceClient::partnerName()} for help formatting this field.
 */
function get_partner_sample(string $formattedName): void
{
    // Create a client.
    $partnerServiceClient = new PartnerServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var Partner $response */
        $response = $partnerServiceClient->getPartner($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 = PartnerServiceClient::partnerName('[NETWORK_CODE]', '[PARTNER]');

    get_partner_sample($formattedName);
}

use Google\Ads\AdManager\V1\Client\PartnerServiceClient;
use Google\Ads\AdManager\V1\ListPartnersRequest;
use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;

/**
 * @param string $formattedParent The parent, which owns this collection of
 *                                [Partner][google.ads.admanager.v1.Partner]s. Format:
 *                                `networks/{network_code}`
 *                                Please see {@see PartnerServiceClient::networkName()} for help formatting this field.
 */
function list_partners_sample(string $formattedParent): void
{
    // Create a client.
    $partnerServiceClient = new PartnerServiceClient();

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

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $partnerServiceClient->listPartners($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());
    }
}

/**
 * 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 = PartnerServiceClient::networkName('[NETWORK_CODE]');

    list_partners_sample($formattedParent);
}

use Google\Ads\AdManager\V1\Client\PartnerServiceClient;
use Google\Ads\AdManager\V1\Partner;
use Google\Ads\AdManager\V1\UpdatePartnerRequest;
use Google\ApiCore\ApiException;

/**
 * @param string $partnerDisplayName The display name of the
 *                                   [Partner][google.ads.admanager.v1.Partner].
 */
function update_partner_sample(string $partnerDisplayName): void
{
    // Create a client.
    $partnerServiceClient = new PartnerServiceClient();

    // Prepare the request message.
    $partner = (new Partner())
        ->setDisplayName($partnerDisplayName);
    $request = (new UpdatePartnerRequest())
        ->setPartner($partner);

    // Call the API and handle any network failures.
    try {
        /** @var Partner $response */
        $response = $partnerServiceClient->updatePartner($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
{
    $partnerDisplayName = '[DISPLAY_NAME]';

    update_partner_sample($partnerDisplayName);
}