Link do YouTube
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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:
- 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 wycofać prośbę, która została przedłużona, zanim zostanie zaakceptowana, a także usunąć połączony film po jego zaakceptowaniu.
- 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 stosowane 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, na który 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. Nie należy ustawiać parametru statusDataLink. Serwer Google Ads API ustawi go 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, zmieniając wartość status elementu
DataLink z REQUESTED na REVOKED. |
| Usuwanie linku |
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, które możesz zaakceptować lub odrzucić. |
| Akceptowanie lub odrzucanie prośby o połączenie |
Aby zaktualizować stan DataLink na ENABLED (zaakceptować prośbę) lub REJECTED (odrzucić prośbę), użyj metody
DataLinkService.UpdateDataLink. |
W tym przepływie pracy mogą wystąpić te typowe błędy:
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-27 UTC."],[],[],null,["# Link YouTube\n\nThe Google Ads API supports linking YouTube videos to your Google Ads account. This guide\nexplains how to use the API to add and remove links to your account.\n\nLink videos\n-----------\n\nVideos can be linked to your account in one of two ways, depending on who starts\nthe process, either:\n\n1. You request that a video is linked to your account. In this scenario, you send a request to a creator, which they must accept in order to establish the link to their video. You can revoke a request that has been extended before it's accepted, and also remove a linked video after it's accepted.\n2. The creator of the video requests that their video is linked to your Google Ads account. You can then choose to accept or reject their request.\n\nThe following methods are used in each scenario:\n\n| Scenario | Action | Remarks |\n| Scenario 1 | Get the video information from the YouTube API | Use the [YouTube API](https://developers.google.com/youtube/v3/docs/channels/list) to get the `channel_id` to send the video link request to, or the `video_id` of the video you want to link. The `video_id` can also be pulled from the URL of a video by pulling the 11 characters after `\"v=\"`. |\n| Scenario 1 |\n| Scenario 1 |\n| Scenario 1 |\n| Scenario 1 |\n|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Create a link request | Use the [`DataLinkService.CreateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/CreateDataLink) method to create a link request. The [`status`](/google-ads/api/reference/rpc/v21/DataLink#status) of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) shouldn't be set; the Google Ads API server will set this to `REQUESTED` upon the successful completion of the API call. |\n| Inspect the status of a request | Use [`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream) or [`GoogleAdsService.Search`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Search) to query the [`data_link`](/google-ads/api/fields/v21/data_link) resource and inspect its [`status`](/google-ads/api/fields/v21/data_link#data_link.status). |\n| Revoke a request | Use the [`DataLinkService.UpdateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/UpdateDataLink) method to revoke a link request by changing the [`status`](/google-ads/api/reference/rpc/v21/DataLink#status) of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) from `REQUESTED` to `REVOKED`. |\n| Remove a link | Use [`DataLinkService.RemoveDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/RemoveDataLink) to remove a linked video. |\n| Accept or reject a link request | Use the [`DataLinkService.UpdateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/UpdateDataLink) method to update the status of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) to `ENABLED` to accept or `REJECTED` to reject the request. |\n\nThe following common errors can be thrown in this workflow:\n\n| Error code | Explanation |\n|----------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|\n| [`DataLinkError.PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/DataLinkErrorEnum.DataLinkError#permission_denied) | The customer doesn't have the permission to perform this action. |\n| [`DataLinkError.YOUTUBE_VIDEO_ID_INVALID`](/google-ads/api/reference/rpc/v21/DataLinkErrorEnum.DataLinkError#youtube_video_id_invalid) | A video link couldn't be created, since the video ID is invalid. |"]]
