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 tym przypadku wysyłasz prośbę do twórcy, którą musi on zaakceptować, aby utworzyć połączenie z jego filmem. Możesz odwołać 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 API YouTube	Użyj interfejsu API YouTube , aby uzyskać channel_id do wysłania prośby o połączenie filmu oraz video_id filmu, który chcesz połączyć. video_id to 11-znakowy ciąg znaków znajdujący się w adresach URL filmów na YouTube (na przykład parametr v w www.youtube.com/watch?v=VIDEO_ID lub ścieżka w youtu.be/VIDEO_ID).
	Utwórz prośbę o połączenie	Aby utworzyć prośbę o połączenie, użyj metody DataLinkService.CreateDataLink , określając zarówno youtube_video.channel_id i youtube_video.video_id , aby zidentyfikować film i powiązany z nim kanał. Od wersji 24 możesz też określić youtube_link_metadata.brand_channel_id, aby podać identyfikator połączonego kanału firmowego w YouTube i pomóc twórcom lepiej poznać Twoją markę. 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	Aby wysłać zapytanie do zasobu data_link i sprawdzić jego status, użyj GoogleAdsService.SearchStream lub GoogleAdsService.Search.
	Anulowanie prośby	Aby odwołać prośbę o połączenie, użyj metody DataLinkService.UpdateDataLink, zmieniając status elementu DataLink z REQUESTED na REVOKED.
	Jak usunąć połączenie	Aby usunąć połączony film, użyj metody DataLinkService.RemoveDataLink.
Scenariusz 2	Pobieranie zaproszenia	Aby wysłać zapytanie do zasobu data_link , użyj GoogleAdsService.Search lub GoogleAdsService.SearchStream. 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 linków do filmów na YouTube, w tym identyfikator filmu na YouTube i identyfikator kanału:

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.
DataLinkError.INVALID_STATUS	Występuje, gdy bieżący stan połączenia danych jest nieprawidłowy dla żądanej operacji.
DataLinkError.INVALID_UPDATE_STATUS	Występuje, gdy podczas aktualizacji następuje nieobsługiwane przejście stanu (np. bezpośrednie przejście ze stanu REVOKED do ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS	Występuje, gdy połączenie danych z filmem już istnieje.