Link do YouTube

Interfejs Google Ads API obsługuje łączenie filmów w YouTube z kontem Google Ads. Z tego przewodnika dowiesz się, jak za pomocą interfejsu API dodawać i usuwać połączenia z kontem.

Łączenie filmów

Filmy można połączyć z kontem na 2 sposoby, w zależności od tego, kto rozpoczyna proces:

1. Prosisz o połączenie filmu z Twoim kontem. W tym przypadku wysyłasz prośbę do twórcy, którą musi on zaakceptować, aby utworzyć połączenie z jego filmem. Możesz cofnąć prośbę, która została przedłużona, zanim zostanie zaakceptowana, a także usunąć połączony film po jego zaakceptowaniu.
2. Twórca filmu prosi o połączenie jego filmu z Twoim kontem Google Ads. Możesz wtedy zaakceptować lub odrzucić prośbę.

W każdym scenariuszu używane są te metody:

Scenariusz	Działanie	Uwagi
Scenariusz 1	Pobieranie informacji o filmie z interfejsu YouTube API	Użyj interfejsu API YouTube, aby uzyskać channel_id, do którego chcesz wysłać prośbę o link do filmu, lub video_id filmu, do którego chcesz utworzyć link. video_id można też pobrać z adresu URL filmu, wyodrębniając 11 znaków po "v=".
	Utwórz prośbę o połączenie	Aby utworzyć prośbę o połączenie, użyj metody DataLinkService.CreateDataLink. Możesz opcjonalnie określić youtube_video.channel_id, aby wyraźnie zidentyfikować kanał powiązany z filmem, oraz youtube_link_metadata.brand_channel_id, aby podać identyfikator połączonego kanału marki w YouTube i pomóc twórcom lepiej poznać Twoją markę. Pola status w DataLink nie powinny być ustawione. Serwer interfejsu Google Ads API ustawi je na REQUESTED po pomyślnym zakończeniu wywołania interfejsu API.
	Sprawdzanie stanu prośby	Użyj GoogleAdsService.SearchStream lub GoogleAdsService.Search, aby wysłać zapytanie do zasobu data_link i sprawdzić jego status.
	Anulowanie prośby	Aby cofnąć prośbę o połączenie, użyj metody DataLinkService.UpdateDataLink i zmień wartość status w  DataLink z REQUESTED na REVOKED.
	Usuwanie połączenia	Użyj DataLinkService.RemoveDataLink, aby usunąć połączony film.
Scenariusz 2	Odzyskiwanie zaproszenia	Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie do zasobu data_link. Filtruj według status = PENDING_APPROVAL, aby znaleźć prośby o połączenie do zaakceptowania lub odrzucenia.
	Akceptowanie i odrzucanie próśb o połączenie	Aby zaktualizować stan elementu DataLink na ENABLED (akceptacja) lub REJECTED (odrzucenie) prośby, użyj metody DataLinkService.UpdateDataLink.

Pobieranie szczegółów połączenia

Do wysyłania zapytań do zasobu data_link możesz używać tych formatów:GoogleAdsService.Search lub GoogleAdsService.SearchStream. To zapytanie pobiera szczegóły linków do filmów na YouTube, w tym identyfikator kanału na YouTube i identyfikator powiązanego kanału partnerskiego w YouTube.

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id,
  data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

W tym przepływie zadań mogą wystąpić te typowe błędy:

Kod błędu	Wyjaśnienie
DataLinkError.PERMISSION_DENIED	Klient nie ma uprawnień do wykonania tej czynności.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Nie udało się utworzyć linku do filmu, ponieważ identyfikator filmu jest nieprawidłowy.