Mapowanie pól

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:

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
  • 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 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 customer_id obiektu resource_name w ProductLink wskazuje, które konto jest właścicielem istniejącego połączenia. Podczas tworzenia ProductLink wskazujesz właściciela linku, ustawiając customer_id elementu CreateProductLinkRequest.

W interfejsie Data Manager API kombinacja parametrów accountType i accountId obiektu owning_account wskazuje, które konto jest właścicielem istniejącego połączenia. Podczas tworzenia zasobu 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 Żą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 ProductLink ma taki format:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

W interfejsie Data Manager API nazwa zasobu PartnerLink ma 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 SearchGoogleAdsRequest zawierające 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 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 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.