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 استفاده کنید. status DataLink نباید تنظیم شود. سرور Google Ads API این را روی REQUESTED پس از تکمیل موفقیت آمیز تماس API تنظیم می کند. | |
| وضعیت یک درخواست را بررسی کنید | از GoogleAdsService.SearchStream یا GoogleAdsService.Search برای پرس و جو از منبع data_link و بررسی status آن استفاده کنید. | |
| ابطال یک درخواست | از روش DataLinkService.UpdateDataLink برای لغو درخواست پیوند با تغییر status DataLink از REQUESTED به REVOKED استفاده کنید. | |
| یک پیوند را حذف کنید | از DataLinkService.RemoveDataLink برای حذف یک ویدیوی پیوند شده استفاده کنید. | |
| سناریو 2 | بازیابی دعوت نامه | از GoogleAdsService.Search یا GoogleAdsService.SearchStream برای جستجو در منبع data_link استفاده کنید. فیلتر برای status = PENDING_APPROVAL برای یافتن درخواست‌های پیوند برای پذیرش یا رد کردن. |
| پذیرش یا رد درخواست پیوند | از روش DataLinkService.UpdateDataLink برای به روز رسانی وضعیت DataLink به ENABLED برای پذیرش یا REJECTED برای رد درخواست استفاده کنید. |
خطاهای رایج زیر را می توان در این گردش کار ایجاد کرد:
| کد خطا | توضیح |
|---|---|
DataLinkError.PERMISSION_DENIED | مشتری مجوز انجام این عمل را ندارد. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID | پیوند ویدیویی ایجاد نشد، زیرا شناسه ویدیو نامعتبر است. |