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 obiektu zawierają mapowania pól zasobu, który reprezentuje obiekt linku partnera.
• Mapowania próśb o zarządzanie linkami zawierają mapowania pól dla próśb o utworzenie i usunięcie linku 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 zakresie innym niż interfejs Google Ads API. Musisz wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API do zarządzania linkami partnerów.

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.

Najważniejsza uwaga: element ProductLink i element PartnerLink to różne reprezentacje tej samej podstawowej jednostki linku. Jeśli masz już ProductLink w interfejsie Google Ads API , możesz go pobrać i nim zarządzać jako PartnerLink w interfejsie Data Manager API. Nie próbuj tworzyć kolejnego PartnerLink dla tej samej pary kont.

ProductLink (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ści identyfikujące połączone konto.
product_link_id	partner_link_id
resource_name	name	W interfejsie Google Ads API pole customer_id w obiekcie resource_nameProductLink wskazuje, które konto jest właścicielem istniejącego połączenia. Podczas tworzenia ProductLinkokreś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 wskazujesz 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 nazwa zasobu ProductLink 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ń z partnerami.

Utwórz prośbę

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

CreateProductLinkRequest (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ę

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

RemoveProductLinkRequest (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óry 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ą zostać zwrócone. Klauzula SELECT zapytania określa, które pola mają być wypełniane w zwracanych zasobach częściowych.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...

Data Manager API

Wyślij SearchPartnerLinksRequest. Opcjonalne pole żądania filter okreś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 SearchGoogleAdsRequest w interfejsie Google Ads API w odpowiednik SearchPartnerLinksRequest w interfejsie Data Manager API.

SearchGoogleAdsRequest (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.