رابط برنامهنویسی کاربردی گوگل ادز (Google Ads API) از لینک دادن ویدیوهای یوتیوب به حساب گوگل ادز شما پشتیبانی میکند. این راهنما نحوه استفاده از API برای اضافه کردن و حذف لینکها به حساب کاربری شما را توضیح میدهد.
لینک ویدیوها
ویدیوها میتوانند به یکی از دو روش زیر به حساب شما متصل شوند، بسته به اینکه چه کسی این فرآیند را شروع میکند:
- شما درخواست میکنید که یک ویدیو به حساب کاربری شما لینک شود. در این سناریو، شما درخواستی را برای سازنده ارسال میکنید که برای ایجاد لینک به ویدیوی خود، باید آن را بپذیرد. میتوانید درخواستی را که قبل از پذیرش تمدید شده است، لغو کنید و همچنین ویدیوی لینک شده را پس از پذیرش حذف کنید.
- سازنده ویدیو درخواست میکند که ویدیوی او به حساب گوگل ادز شما لینک شود. سپس میتوانید درخواست او را بپذیرید یا رد کنید.
در هر سناریو از روشهای زیر استفاده میشود:
| سناریو | اکشن | اظهارات |
|---|---|---|
| سناریوی ۱ | اطلاعات ویدیو را از API یوتیوب دریافت کنید | از API یوتیوب برای دریافت channel_id جهت ارسال درخواست لینک ویدیو یا video_id ویدیویی که میخواهید لینک دهید، استفاده کنید. video_id را همچنین میتوان با اضافه کردن ۱۱ کاراکتر بعد از "v=" از URL یک ویدیو استخراج کرد. |
| ایجاد درخواست لینک | از متد DataLinkService.CreateDataLink برای ایجاد درخواست لینک استفاده کنید. میتوانید به صورت اختیاری youtube_video.channel_id را برای شناسایی صریح کانال مرتبط با ویدیو مشخص کنید. status DataLink نباید تنظیم شود؛ سرور API تبلیغات گوگل پس از اتمام موفقیتآمیز فراخوانی API، این وضعیت را به REQUESTED تنظیم میکند. | |
| بررسی وضعیت یک درخواست | برای جستجوی منبع data_link و بررسی status آن، GoogleAdsService.SearchStream یا GoogleAdsService.Search استفاده کنید. | |
| لغو یک درخواست | از متد DataLinkService.UpdateDataLink برای لغو درخواست لینک با تغییر status DataLink از REQUESTED به REVOKED استفاده کنید. | |
| حذف یک لینک | برای حذف یک ویدیوی لینکشده DataLinkService.RemoveDataLink استفاده کنید. | |
| سناریوی ۲ | دریافت دعوتنامه | برای جستجوی منبع data_link GoogleAdsService.Search یا GoogleAdsService.SearchStream استفاده کنید. برای یافتن درخواستهای لینک جهت پذیرش یا رد، status = PENDING_APPROVAL را فیلتر کنید. |
| درخواست پیوند را بپذیرید یا رد کنید | از متد DataLinkService.UpdateDataLink برای بهروزرسانی وضعیت DataLink به ENABLED برای پذیرش) یا REJECTED برای رد درخواست) استفاده کنید. |
جزئیات پیوند را بازیابی کنید
شما میتوانید GoogleAdsService.Search یا GoogleAdsService.SearchStream برای جستجوی منبع data_link استفاده کنید. عبارت زیر جزئیات مربوط به لینکهای ویدیوی یوتیوب، از جمله شناسه کانال یوتیوب را بازیابی میکند.
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'
خطاهای رایج زیر را میتوان در این گردش کار مشاهده کرد:
| کد خطا | توضیح |
|---|---|
DataLinkError.PERMISSION_DENIED | مشتری اجازه انجام این عمل را ندارد. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID | پیوند ویدیویی ایجاد نشد، زیرا شناسه ویدیو نامعتبر است. |