Tworzenie i usuwanie linku partnerskiego

Oto jak utworzyć lub usunąć zasób PartnerLink. Interfejs Data Manager API umożliwia tworzenie połączeń z partnerami w przypadku tych typów kont:

konta Google Ads,
konta partnera Display & Video 360 lub konta reklamodawcy Display & Video 360;

Tworzenie linku

Utwórz PartnerLink, wysyłając CreatePartnerLinkRequest.

Tworzenie treści żądania

Utwórz zasób PartnerLink. Oto pola do ustawienia.

owning_account

Identyfikuje konto reklamodawcy, do którego należy link. Ustaw na obiekt ProductAccount.

Ustaw account_type na AccountType konta reklamodawcy.

Ustaw account_id na identyfikator konta reklamodawcy.

W przewodniku po miejscach docelowych i nagłówkach znajdziesz instrukcje dotyczące identyfikatora, którego należy użyć w przypadku każdego typu reklamodawcy.

partner_account

Identyfikuje konto partnera. Ustaw na obiekt ProductAccount.

Ustaw account_type na AccountType konta partnera. Jeśli np. połączenie jest między kontem reklamodawcy a kontem dostawcy danych, ustaw to pole na DATA_PARTNER.

Ustaw account_id na identyfikator konta partnera.

Tworzenie żądania

Aby utworzyć link partnera, utwórz CreatePartnerLinkRequest.

Ustaw parent na nazwę zasobu konta reklamodawcy. Użyj formatu:
```
accountTypes/{account_type}/accounts/{account}
```
Ustaw wartość partner_link na skonstruowany zasób PartnerLink.
Jeśli Twoje dane logowania dotyczą konta Google, które ma dostęp do konta nadrzędnego konta reklamodawcy, np. konta menedżera Google Ads lub konta partnera Display & Video 360, ustaw nagłówek login-account zgodnie z opisem w sekcji Konfigurowanie miejsc docelowych i nagłówków.

Oto przykładowe żądania w formacie JSON umożliwiające utworzenie połączenia z kontem dostawcy danych na różnych typach kont reklamodawców.

Google Ads

Otwórz w API Explorer

{
    "parent": "accountTypes/GOOGLE_ADS/accounts/INSERT_GOOGLE_ADS_CUSTOMER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "GOOGLE_ADS",
            "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Reklamodawca DV360

Otwórz w API Explorer

{
    "parent": "accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/INSERT_DISPLAY_VIDEO_ADVERTISER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_ADVERTISER",
            "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Partner DV360

Otwórz w API Explorer

{
    "parent": "accountTypes/DISPLAY_VIDEO_PARTNER/accounts/INSERT_DISPLAY_VIDEO_PARTNER_ID",
    "partner_link": {
        "owning_account": {
            "accountType": "DISPLAY_VIDEO_PARTNER",
            "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
        },
        "partner_account": {
            "accountType": "DATA_PARTNER",
            "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
        }
    }
}

Wysyłanie żądania

Wyślij żądanie i w razie potrzeby dołącz nagłówki żądania. Użyj danych logowania na konto Google, które ma dostęp do usługi owning_account.

Jeśli żądanie się powiedzie, odpowiedź będzie zawierać utworzony obiekt PartnerLink z wypełnionymi polami id i name.

Jeśli żądanie się nie powiedzie, sprawdź błędy, aby określić przyczynę niepowodzenia, zaktualizuj żądanie i nagłówki, aby rozwiązać problemy, a następnie wyślij zaktualizowane żądanie i nagłówki.