Tworzenie i usuwanie linku partnerskiego

Oto jak utworzyć lub usunąć zasób PartnerLink. Interfejs Data Manager API obsługuje tworzenie linków do partnerów w przypadku tych typów kont:

• konta Google Ads,
• konta partnera lub reklamodawcy Display & Video 360.

Tworzenie połączenia

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

Tworzenie treści żądania

Utwórz zasób PartnerLink. Oto pola, które należy ustawić.

owning_account

Identyfikuje konto reklamodawcy, które jest właścicielem linku. Ustaw na a ProductAccount obiekt.

Ustaw account_type na AccountType konta reklamodawcy.

Ustaw account_id na identyfikator konta reklamodawcy.

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

partner_account

Identyfikuje konto partnera. Ustaw na obiekt ProductAccount.

Ustaw account_type na AccountType konta partnera. Jeśli na przykład link prowadzi z konta reklamodawcy do konta dostawcy danych, ustaw to pole na DATA_PARTNER.

Ustaw account_id na identyfikator konta partnera.

Tworzenie żądania

Aby utworzyć link do partnera, utwórz CreatePartnerLinkRequest.

1. Ustaw parent na nazwę zasobu konta reklamodawcy. Użyj formatu:

   accountTypes/{account_type}/accounts/{account}
   

2. Ustaw partner_link na utworzony zasób PartnerLink.

3. Jeśli Twoje dane logowania dotyczą konta Google z dostępem 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, które umożliwiają utworzenie linku do konta dostawcy danych na różnych typach kont reklamodawców.

{
    "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"
        }
    }
}

{
    "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"
        }
    }
}

{
    "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 do konta Google z dostępem do owning_account.

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

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

Usuwanie połączenia

Aby usunąć PartnerLink, wyślij DeletePartnerLinkRequest z ustawioną nazwą name na nazwę zasobu. Ustaw nagłówki w razie potrzeby.