Google Ads Data Manager V1 Client - Class PartnerLinkServiceClient (0.4.0)

 use Google\Ads\DataManager\V1\Client\PartnerLinkServiceClient;
use Google\Ads\DataManager\V1\CreatePartnerLinkRequest;
use Google\Ads\DataManager\V1\PartnerLink;
use Google\Ads\DataManager\V1\ProductAccount;
use Google\ApiCore\ApiException;

/**
 * @param string $formattedParent                    The parent, which owns this collection of partner links.
 *                                                   Format: accountTypes/{account_type}/accounts/{account}
 *                                                   Please see {@see PartnerLinkServiceClient::accountName()} for help formatting this field.
 * @param string $partnerLinkOwningAccountAccountId  The ID of the account. For example, your Google Ads account ID.
 * @param string $partnerLinkPartnerAccountAccountId The ID of the account. For example, your Google Ads account ID.
 */
function create_partner_link_sample(
    string $formattedParent,
    string $partnerLinkOwningAccountAccountId,
    string $partnerLinkPartnerAccountAccountId
): void {
    // Create a client.
    $partnerLinkServiceClient = new PartnerLinkServiceClient();

    // Prepare the request message.
    $partnerLinkOwningAccount = (new ProductAccount())
        ->setAccountId($partnerLinkOwningAccountAccountId);
    $partnerLinkPartnerAccount = (new ProductAccount())
        ->setAccountId($partnerLinkPartnerAccountAccountId);
    $partnerLink = (new PartnerLink())
        ->setOwningAccount($partnerLinkOwningAccount)
        ->setPartnerAccount($partnerLinkPartnerAccount);
    $request = (new CreatePartnerLinkRequest())
        ->setParent($formattedParent)
        ->setPartnerLink($partnerLink);

    // Call the API and handle any network failures.
    try {
        /** @var PartnerLink $response */
        $response = $partnerLinkServiceClient->createPartnerLink($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 = PartnerLinkServiceClient::accountName('[ACCOUNT_TYPE]', '[ACCOUNT]');
    $partnerLinkOwningAccountAccountId = '[ACCOUNT_ID]';
    $partnerLinkPartnerAccountAccountId = '[ACCOUNT_ID]';

    create_partner_link_sample(
        $formattedParent,
        $partnerLinkOwningAccountAccountId,
        $partnerLinkPartnerAccountAccountId
    );
} 

 use Google\Ads\DataManager\V1\Client\PartnerLinkServiceClient;
use Google\Ads\DataManager\V1\DeletePartnerLinkRequest;
use Google\ApiCore\ApiException;

/**
 * @param string $formattedName The resource name of the partner link to delete.
 *                              Format:
 *                              accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
 *                              Please see {@see PartnerLinkServiceClient::partnerLinkName()} for help formatting this field.
 */
function delete_partner_link_sample(string $formattedName): void
{
    // Create a client.
    $partnerLinkServiceClient = new PartnerLinkServiceClient();

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

    // Call the API and handle any network failures.
    try {
        $partnerLinkServiceClient->deletePartnerLink($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 = PartnerLinkServiceClient::partnerLinkName(
        '[ACCOUNT_TYPE]',
        '[ACCOUNT]',
        '[PARTNER_LINK]'
    );

    delete_partner_link_sample($formattedName);
} 

 use Google\Ads\DataManager\V1\Client\PartnerLinkServiceClient;
use Google\Ads\DataManager\V1\PartnerLink;
use Google\Ads\DataManager\V1\SearchPartnerLinksRequest;
use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;

/**
 * @param string $formattedParent Account to search for partner links. If no `filter` is specified,
 *                                all partner links where this account is either the `owning_account` or
 *                                `partner_account` are returned.
 *
 *                                Format: `accountTypes/{account_type}/accounts/{account}`
 *                                Please see {@see PartnerLinkServiceClient::accountName()} for help formatting this field.
 */
function search_partner_links_sample(string $formattedParent): void
{
    // Create a client.
    $partnerLinkServiceClient = new PartnerLinkServiceClient();

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

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

        /** @var PartnerLink $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 = PartnerLinkServiceClient::accountName('[ACCOUNT_TYPE]', '[ACCOUNT]');

    search_partner_links_sample($formattedParent);
}