Google Ads API از پیوند دادن ویدیوهای 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 تنظیم خواهد کرد. |
|
| بررسی وضعیت درخواست | از GoogleAdsService.SearchStream یا GoogleAdsService.Search برای پرسمان منبع data_link استفاده کنید و
status آن را بازرسی کنید. |
|
| لغو کردن درخواست | از روش
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 |
وقتی پیوند داده برای ویدیو ازقبل وجود داشته باشد، این خطا ایجاد می‌شود. |