Użyj mapowania pól, aby uaktualnić każdy krok przepływów pracy związanych z połączeniem z usługą partnera z interfejsu Google Ads API do interfejsu Data Manager API:
- Mapowania pól obiektów zawierają mapowania pól zasobu, który reprezentuje obiekt linku partnera.
- Mapowania żądań zarządzania połączeniami zawierają mapowania pól dla żądań utworzenia i usunięcia połączenia partnera.
- Mapowania żądań pobierania linków zawierają mapowania pól do pobierania linków partnerów.
Uwierzytelnianie
Interfejs Data Manager API wymaga danych logowania o innym zakresie niż interfejs Google Ads API. Musisz wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API do zarządzania połączeniami z partnerami.
Mapowania pól obiektów
Użyj mapowań w tabelach, aby zmapować ProductLink w interfejsie Google Ads API na odpowiednik PartnerLink w interfejsie Data Manager API.
ProductLink (interfejs Google Ads API) |
PartnerLink (Data Manager API) |
Uwagi |
|---|---|---|
|
partner_account |
Interfejs Data Manager API nie ma oddzielnych pól dla każdego typu połączonego konta.
W przypadku wszystkich rodzajów kont ustaw pole partner_account na ProductAccount, a pola account_type i account_id ustaw tak, aby identyfikowały połączone konto.
|
product_link_id |
partner_link_id |
|
resource_name |
name |
W interfejsie Google Ads API pole
W interfejsie Data Manager API kombinacja parametrów Szczegółowe informacje znajdziesz w sekcjach Nazwy zasobów i Żądanie utworzenia. |
type |
owning_account.account_type |
Nazwy zasobów
Interfejs Data Manager API używa innego formatu nazwy zasobu niż interfejs Google Ads API.
- Interfejs Google Ads API
W interfejsie Google Ads API nazwa zasobu
ProductLinkma taki format:customers/{customer_id}/productLinks/{product_link_id}- Data Manager API
W interfejsie Data Manager API nazwa zasobu
PartnerLinkma taki format:accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}
Mapowania próśb o zarządzanie połączeniami
Użyj mapowań żądań w tej sekcji, aby przekonwertować żądania tworzenia, usuwania i pobierania połączeń z partnerami.
Utwórz prośbę
Oto mapowania pól, które umożliwiają przekształcenie obiektu CreateProductLinkRequest w interfejsie Google Ads API w jego odpowiednik CreatePartnerLinkRequest w interfejsie Data Manager API.
CreateProductLinkRequest (interfejs Google Ads API) |
CreatePartnerLinkRequest (Data Manager API) |
Uwagi |
|---|---|---|
customer_id |
parent |
Ustaw nazwę zasobu konta reklamodawcy, który jest właścicielem. |
product_link |
partner_link |
Ustaw na zasób PartnerLink. Zobacz Mapowania pól obiektów.
|
Wycofaj prośbę
Oto mapowania pól, które umożliwiają przekształcenie obiektu RemoveProductLinkRequest w interfejsie Google Ads API w jego odpowiednik DeletePartnerLinkRequest w interfejsie Data Manager API.
RemoveProductLinkRequest (interfejs Google Ads API) |
DeletePartnerLinkRequest (Data Manager API) |
Uwagi |
|---|---|---|
customer_id |
Brak odpowiednika. |
Pole name zawiera konta właściciela i partnera, więc to dodatkowe pole nie jest potrzebne.
|
resource_name |
name |
Ustaw nazwę zasobu PartnerLink, który chcesz usunąć.
|
validate_only |
Brak odpowiednika. |
Mapowania żądań pobierania linków
Sposób pobierania linków partnerów różni się między interfejsem Google Ads API a interfejsem Data Manager API.
- Interfejs Google Ads API
Wyślij
SearchGoogleAdsRequestzawierającequery. Opcjonalna klauzulaWHEREzapytania określa, które zasoby mają zostać zwrócone. KlauzulaSELECTzapytania określa, które pola mają zostać wypełnione w zwracanych zasobach częściowych.SELECT product_link.product_link_id, ... FROM product_link WHERE ...- Data Manager API
Wyślij
SearchPartnerLinksRequest. Opcjonalne pole żądaniafilterokreśla, które zasoby mają zostać zwrócone. Odpowiedź zawiera pełne zasoby ze wszystkimi wypełnionymi polami.
Oto mapowania pól, które umożliwiają przekształcenie obiektu SearchGoogleAdsRequest w interfejsie Google Ads API w jego odpowiednik SearchPartnerLinksRequest w interfejsie Data Manager API.
SearchGoogleAdsRequest (interfejs Google Ads API) |
SearchPartnerLinksRequest (Data Manager API) |
Uwagi |
|---|---|---|
customer_id |
parent |
Ustaw nazwę zasobu konta, które chcesz wyszukać. |
page_size |
page_size |
|
page_token |
page_token |
|
query |
filter |
Ustaw filter, aby określić, które zasoby mają być zwracane. Interfejs Data Manager API zwraca pełne zasoby, więc nie ma odpowiednika klauzuli SELECT.
|
search_settings |
Brak odpowiednika. | |
validate_only |
Brak odpowiednika. |
Więcej informacji, m.in. o tym, jak utworzyć filter żądania SearchPartnerLinksRequest i ustawić nagłówki żądania w różnych scenariuszach, znajdziesz w artykule Pobieranie linków partnera.