Link do YouTube

Interfejs Google Ads API umożliwia łą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 ten proces:

1. Prosisz o połączenie filmu z Twoim kontem. W takim 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 wysłana, zanim została zaakceptowana, a także usunąć połączony film po jego zaakceptowaniu.
2. Twórca filmu prosi o połączenie swojego filmu z Twoim kontem Google Ads. Możesz wtedy zaakceptować lub odrzucić jego 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 YouTube API , aby uzyskać channel_id do wysłania prośby o połączenie filmu lub video_id filmu, który chcesz połączyć. Wartość 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. Opcjonalnie możesz określić youtube_video.channel_id aby jednoznacznie zidentyfikować kanał powiązany z filmem. Nie należy ustawiać status elementu DataLink. Serwer interfejsu Google Ads API ustawi tę wartość 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 anulować prośbę o połączenie, użyj metody DataLinkService.UpdateDataLink, zmieniając status elementu DataLink z REQUESTED na REVOKED.
	Usuwanie połączenia	Aby usunąć połączony film, użyj metody DataLinkService.RemoveDataLink.
Scenariusz 2	Pobieranie zaproszenia	Użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream , aby wysłać zapytanie do zasobu data_link. Aby znaleźć prośby o połączenie , które chcesz zaakceptować lub odrzucić, zastosuj filtr status = PENDING_APPROVAL.
	Akceptowanie lub odrzucanie prośby o połączenie	Aby zaakceptować prośbę, użyj metody DataLinkService.UpdateDataLink, aby zaktualizować status DataLink na ENABLED. Aby odrzucić prośbę, ustaw stan na REJECTED.

Pobieranie szczegółów połączenia

Aby wysłać zapytanie do zasobu data_link, możesz użyć GoogleAdsService.Search lub GoogleAdsService.SearchStream. To zapytanie pobiera szczegóły filmów na YouTube, w tym identyfikator kanału w YouTube.

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

W tym procesie 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 można utworzyć połączenia z filmem, ponieważ identyfikator filmu jest nieprawidłowy.