Создать или удалить партнерскую ссылку

Вот как создать или удалить ресурс PartnerLink . API Data Manager поддерживает создание партнерских ссылок для следующих типов учетных записей:

• Аккаунты Google Ads
• Партнерские аккаунты Display & Video 360 или рекламные аккаунты Display & Video 360

Создать ссылку

Создайте PartnerLink , отправив запрос CreatePartnerLinkRequest .

Сформируйте тело запроса.

Создайте ресурс PartnerLink . Вот поля, которые необходимо настроить.

owning_account

Определяет рекламный аккаунт, которому принадлежит ссылка. Устанавливается в объект ProductAccount .

Установите параметр account_type равным AccountType записи рекламодателя.

Установите параметр account_id равным идентификатору аккаунта рекламодателя.

Для получения инструкций по использованию идентификатора для каждого типа рекламодателя обратитесь к руководству по целевым адресам и заголовкам .

partner_account

Идентифицирует партнерский аккаунт. Устанавливается в объект ProductAccount .

Установите для account_type , равное AccountType записи партнера. Например, если ссылка ведет от учетной записи рекламодателя к учетной записи партнера по данным, установите для этого поля значение DATA_PARTNER .

Установите параметр account_id равным идентификатору партнерского аккаунта.

Составьте запрос

To create a partner link, construct a CreatePartnerLinkRequest .

1. В parent укажите имя ресурса учетной записи рекламодателя. Используйте следующий формат:

   accountTypes/{account_type}/accounts/{account}
   

2. Установите параметр partner_link на созданный вами ресурс PartnerLink .

3. If your credentials are for a Google Account with access to a parent account of the advertiser account, such as a Google Ads manager account or a Display & Video 360 Partner account, set the login-account header as described in Configure destinations and headers .

Ниже приведены примеры запросов в формате JSON для создания ссылки на аккаунт партнера по данным в различных типах рекламодателей.

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Отправить запрос

Отправьте запрос и, при необходимости, добавьте заголовки запроса . Используйте учетные данные аккаунта Google, имеющего доступ к аккаунту owning_account .

Если запрос выполнен успешно, в ответе будет содержаться созданная PartnerLink с заполненными id и name .

Если запрос не удается, проанализируйте ошибки, чтобы определить причину сбоя, обновите запрос и заголовки, чтобы исправить все проблемы, а затем отправьте обновленный запрос и заголовки.

Удалить ссылку

Для удаления PartnerLink отправьте запрос DeletePartnerLinkRequest , указав в качестве name имя ресурса. При необходимости добавьте заголовки .