با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google Ads API از پیوند دادن ویدیوهای YouTube به حساب Google Ads شما پشتیبانی می کند. این راهنما نحوه استفاده از API را برای افزودن و حذف پیوندها به حساب خود توضیح می دهد.
لینک ویدیوها
بسته به اینکه چه کسی این فرآیند را شروع می‌کند، ویدیوها را می‌توان به یکی از دو روش به حساب شما پیوند داد:
شما درخواست می کنید که یک ویدیو به حساب شما پیوند داده شود. در این سناریو، شما درخواستی را برای یک سازنده ارسال می‌کنید که او باید آن را بپذیرد تا پیوند ویدیوی خود را ایجاد کند. می‌توانید درخواستی را که قبل از پذیرش تمدید شده است لغو کنید، و همچنین پس از پذیرفته شدن یک ویدیوی پیوند داده شده را حذف کنید.
سازنده ویدیو درخواست می‌کند که ویدیوی او به حساب Google Ads شما پیوند داده شود. سپس می توانید درخواست آنها را بپذیرید یا رد کنید.
در هر سناریو از روش های زیر استفاده می شود:
سناریو
اقدام
اظهارات
سناریو 1
اطلاعات ویدیو را از YouTube API دریافت کنید
از YouTube API برای دریافت channel_id برای ارسال درخواست پیوند ویدیو یا video_id ویدیویی که می‌خواهید پیوند دهید استفاده کنید. video_id نیز می‌توان با کشیدن 11 کاراکتر بعد از "v=" از URL یک ویدیو بیرون کشید.
یک درخواست پیوند ایجاد کنید
برای ایجاد درخواست پیوند از روش DataLinkService.CreateDataLink استفاده کنید. statusDataLink نباید تنظیم شود. سرور Google Ads API این را روی REQUESTED پس از تکمیل موفقیت آمیز تماس API تنظیم می کند.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
