Mapowanie pól

Aby zaktualizować każdy etap przepływów pracy związanych z połączeniami z partnerami z interfejsu Google Ads API do interfejsu Data Manager API, użyj mapowań pól:

• Mapowania pól obiektu zawierają mapowania pól zasobu który reprezentuje obiekt połączenia z partnerem.
• Mapowania żądań zarządzania połączeniami zawierają mapowania pól dla żądań tworzenia i usuwania połączenia z partnerem.
• Mapowania żądań pobierania połączeń zawierają mapowania pól pobierania połączeń z partnerami.

Mapowania pól obiektu

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

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

ProductLink (interfejs Google Ads API)	PartnerLink (interfejs 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 ProductAccount, a pola account_type i account_id – tak, aby identyfikować połączone konto.
product_link_id	partner_link_id
resource_name	name	W interfejsie Google Ads API customer_id w resource_name elementu ProductLink wskazuje, które konto jest właścicielem istniejącego połączenia. Gdy tworzysz ProductLink, wskazujesz właściciela połączenia, ustawiając customer_id w 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. Gdy tworzysz PartnerLink, wskazujesz właściciela połączenia, ustawiając name na nazwę zasobu właściciela. Więcej informacji znajdziesz w sekcjach Nazwy zasobów i Utwórz prośbę.
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}

Interfejs Data Manager API

W interfejsie Data Manager API nazwa zasobu PartnerLink ma format:

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

Mapowania żądań zarządzania połączeniami

Aby przekonwertować żądania tworzenia, usuwania i pobierania połączeń z partnerami, użyj mapowań żądań w tej sekcji.

Utwórz prośbę

Oto mapowania pól, które umożliwiają przekonwertowanie CreateProductLinkRequest w interfejsie Google Ads API na jego odpowiednik CreatePartnerLinkRequest w interfejsie Data Manager API.

CreateProductLinkRequest (interfejs Google Ads API)	CreatePartnerLinkRequest (interfejs Data Manager API)	Uwagi
customer_id	parent	Ustaw na nazwę zasobu konta reklamodawcy będącego właścicielem.
product_link	partner_link	Ustaw na zasób PartnerLink. Zobacz Obiekt mapowania pól

Wycofaj prośbę

Oto mapowania pól, które umożliwiają przekonwertowanie RemoveProductLinkRequest w interfejsie Google Ads API na jego odpowiednik DeletePartnerLinkRequest w interfejsie Data Manager API.

RemoveProductLinkRequest (interfejs Google Ads API)	DeletePartnerLinkRequest (interfejs 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 żądań pobierania połączeń

Sposób pobierania połączeń z partnerami różni się w interfejsie Google Ads API i interfejsie 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ą zostać wypełnione w zwracanych częściowych zasobach.

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

Interfejs 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ą przekonwertowanie SearchGoogleAdsRequest w interfejsie Google Ads API na jego odpowiednik SearchPartnerLinksRequest w interfejsie Data Manager API.

SearchGoogleAdsRequest (interfejs Google Ads API)	SearchPartnerLinksRequest (interfejs Data Manager API)	Uwagi
customer_id	parent	Ustaw na nazwę zasobu konta, które chcesz przeszukać.
page_size	page_size
page_token	page_token
query	filter	Ustaw filter, aby określić, które zasoby mają zostać zwrócone. 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ć filter w żądaniu SearchPartnerLinksRequest i ustawić nagłówki żądań w różnych scenariuszach, znajdziesz w artykule Pobieranie połączeń z partnerami.