Mapowanie pól

Użyj mapowań pól, aby uaktualnić każdy krok przepływów pracy związanych z linkami partnerskimi z interfejsu Google Ads API do interfejsu Data Manager API:

Mapowania pól obiektów

Użyj mapowań w tabelach, aby zmapować ProductLink w interfejsie Google Ads API na jego odpowiednik PartnerLink w interfejsie Data Manager API.

ProductLink (interfejs Google Ads API) PartnerLink (Data Manager API) Uwagi
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
 partner_account Interfejs Data Manager API nie ma oddzielnych pól dla każdego typu połączonego konta. W przypadku wszystkich typów kont ustaw pole partner_account na wartość ProductAccount, a pola account_type i account_id na wartość identyfikującą połączone konto.
product_link_id partner_link_id
resource_name name

W interfejsie Google Ads API customer_id w resource_nameProductLink wskazuje, które konto jest właścicielem istniejącego połączenia. Podczas tworzenia ProductLink określasz właściciela linku, ustawiając customer_id elementu CreateProductLinkRequest.

W interfejsie Data Manager API kombinacja accountType i accountId w owning_account wskazuje, które konto jest właścicielem istniejącego połączenia. Podczas tworzenia PartnerLink wskaż właściciela linku, ustawiając name na nazwę zasobu właściciela.

Szczegółowe informacje znajdziesz w sekcjach Nazwy zasobów i Tworzenie żądania.

type owning_account.account_type

Nazwy zasobów

Interfejs Data Manager API używa innego formatu nazw zasobów niż interfejs Google Ads API.

Interfejs Google Ads API

W interfejsie Google Ads API ProductLink nazwa zasobu ma format:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

W interfejsie Data Manager API PartnerLink nazwa zasobu ma format:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

Mapowania próśb o zarządzanie połączeniami

Skorzystaj z mapowań żądań w tej sekcji, aby przekształcać żądania tworzenia, usuwania i pobierania połączeń partnerów.

Utwórz prośbę

Poniżej znajdziesz mapowania pól, które umożliwiają przekształcenie CreateProductLinkRequest w interfejsie Google Ads API w odpowiednik CreatePartnerLinkRequest w interfejsie Data Manager API.

CreateProductLinkRequest (interfejs Google Ads API) CreatePartnerLinkRequest (Data Manager API) Uwagi
customer_id parent Ustaw na nazwę zasobu konta reklamodawcy, do którego należy konto.
product_link partner_link Ustaw na zasób PartnerLink. Zobacz mapowania pól obiektu.

Wycofaj prośbę

Poniżej znajdziesz mapowania pól, które umożliwiają przekształcenie RemoveProductLinkRequest w interfejsie Google Ads API w odpowiednik DeletePartnerLinkRequest w interfejsie Data Manager API.

RemoveProductLinkRequest (interfejs Google Ads API) DeletePartnerLinkRequest (Data Manager API) Uwagi
customer_id Brak odpowiednika. Pole name obejmuje konta właściciela i partnera, więc to dodatkowe pole nie jest potrzebne.
resource_name name Ustaw na nazwę zasobu PartnerLink, którą chcesz usunąć.
validate_only Brak odpowiednika.

Mapowania próśb o pobranie linków

Podejście do pobierania połączeń z partnerami różni się w przypadku interfejsu Google Ads API i interfejsu Data Manager API.

Interfejs Google Ads API

Wyślij SearchGoogleAdsRequest zawierający query. Opcjonalna klauzula WHERE zapytania określa, które zasoby mają być zwracane. Klauzula SELECT zapytania określa, które pola mają być wypełniane w zwracanych zasobach partial.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

Wyślij SearchPartnerLinkRequest. Opcjonalne pole żądania filter określa, które zasoby mają zostać zwrócone. Odpowiedź zawiera pełne zasoby ze wszystkimi wypełnionymi polami.

Poniżej znajdziesz mapowania pól, które umożliwiają przekształcenie SearchGoogleAdsRequest w interfejsie Google Ads API w odpowiednik SearchPartnerLinksRequest w interfejsie Data Manager API.

SearchGoogleAdsRequest (interfejs Google Ads API) SearchPartnerLinksRequest (Data Manager API) Uwagi
customer_id parent Ustaw na nazwę zasobu konta do wyszukania.
page_size page_size
page_token page_token
query filter Ustaw parametr 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, w tym o tym, jak utworzyć żądanie filterSearchPartnerLinksRequest i ustawić nagłówki żądań w różnych scenariuszach, znajdziesz w artykule Pobieranie linków partnera.

Wstecz
Przejście na nową wersję