«میانای برنامه‌سازی کاربردی Google Ads» از پیوند دادن ویدیوهای YouTube به حساب Google Ads شما پشتیبانی می‌کند. این راهنما نحوه استفاده از API را برای افزودن و برداشتن پیوندها به حسابتان توضیح می‌دهد.
پیوند دادن ویدیوها
ویدیوها می‌توانند به یکی از دو روش زیر به حساب شما پیوند داده شوند، بسته به اینکه چه کسی فرایند را شروع می‌کند:
- درخواست می‌کنید که یک ویدیو به حساب شما پیوند داده شود. در این سناریو، شما درخواستی به محتواساز ارسال می‌کنید که باید آن را بپذیرد تا پیوند به ویدیو او ایجاد شود. می‌توانید درخواستی را که تمدید شده است قبل‌از پذیرفته شدن آن پس بگیرید، و همچنین ویدیو پیوندشده را پس‌از پذیرفته شدن آن بردارید.
- محتواساز ویدیو درخواست می‌کند که ویدیواش به حساب Google Ads شما پیوند داده شود. سپس می‌توانید درخواست او را بپذیرید یا رد کنید.
روش‌های زیر در هر سناریو استفاده می‌شود:
| سناریو | کنش | اظهار نظرات |
|---|---|---|
| سناریو ۱ | دریافت اطلاعات ویدیو از YouTube API | از YouTube API
برای دریافت channel_id برای ارسال درخواست پیوند ویدیو به آن، و video_id
ویدیویی که می‌خواهید پیوند دهید استفاده کنید. video_id رشته‌ای ۱۱ نویسه‌ای است که در نشانی‌های وب ویدیو YouTube یافت می‌شود (برای مثال، پارامتر v در www.youtube.com/watch?v=VIDEO_ID یا مسیر در youtu.be/VIDEO_ID). |
| ایجاد درخواست پیوند | از روش
DataLinkService.CreateDataLink
برای ایجاد درخواست پیوند استفاده کنید و هر دو
youtube_video.channel_id و youtube_video.video_id
را برای شناسایی ویدیو و کانال مرتبط با آن مشخص کنید. از نسخه ۲۴، می‌توانید
youtube_link_metadata.brand_channel_id
را نیز مشخص کنید تا شناسه کانال نمانام YouTube پیوندشده را ارائه دهید و به محتواسازان کمک کنید
نمانام شما را درک کنند.
status
DataLink نباید
تنظیم شود؛ سرور Google Ads API پس‌از تکمیل موفقیت‌آمیز فراخوانی API،
این مقدار را روی REQUESTED تنظیم خواهد کرد. |
|
| بررسی وضعیت درخواست | برای پُرسمان کردن منبع data_link
و بازرسی
status آن، از GoogleAdsService.SearchStream یا GoogleAdsService.Search استفاده کنید. |
|
| لغو کردن درخواست | از روش
DataLinkService.UpdateDataLink
برای لغو درخواست پیوند با تغییر status مربوط به
DataLink از REQUESTED به REVOKED استفاده کنید. |
|
| برداشتن پیوند | از
DataLinkService.RemoveDataLink برای برداشتن ویدیو پیوندشده استفاده کنید. |
|
| سناریو ۲ | بازیابی دعوت | از GoogleAdsService.Search
یا GoogleAdsService.SearchStream
برای پرسمان منبع data_link
استفاده کنید. برای پیدا کردن درخواست‌های پیوند،
status = PENDING_APPROVAL را فیلتر کنید
تا آن‌ها را بپذیرید یا رد کنید. |
| پذیرفتن یا رد کردن درخواست پیوند | از روش
DataLinkService.UpdateDataLink برای به‌روزرسانی وضعیت
DataLink
به ENABLED برای پذیرفتن یا REJECTED برای رد کردن
درخواست استفاده کنید. |
بازیابی جزئیات پیوند
می‌توانید از GoogleAdsService.Search
یا
GoogleAdsService.SearchStream
برای پُرسمان منبع data_link استفاده کنید. پُرسمان زیر
جزئیات پیوندهای ویدیو YouTube، ازجمله شناسه ویدیو YouTube و
شناسه کانال را بازیابی می‌کند:
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 |
پیوند ویدیو ایجاد نشد چون شناسه ویدیو نامعتبر است. |
DataLinkError.INVALID_STATUS |
زمانی ایجاد می‌شود که وضعیت فعلی پیوند داده برای عملیات درخواستی نامعتبر باشد. |
DataLinkError.INVALID_UPDATE_STATUS |
این خطا زمانی رخ می‌دهد که درطول به‌روزرسانی، تلاشی برای انتقال وضعیت پشتیبانی‌نشده انجام شود (برای مثال، انتقال مستقیم از REVOKED به ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
وقتی پیوند داده برای ویدیو ازقبل وجود داشته باشد، این خطا ایجاد می‌شود. |