Google Ads API תומך בקישור סרטונים ב-YouTube לחשבון Google Ads. במדריך הזה מוסבר איך להשתמש ב-API כדי להוסיף קישורים לחשבון ולהסיר קישורים ממנו.
קישור סרטונים
יש שתי דרכים לקשר סרטונים לחשבון שלכם, בהתאם למי שמתחיל את התהליך:
- אתם שולחים בקשה לקשר סרטון לחשבון שלכם. במקרה כזה, אתם שולחים בקשה ליוצר, והוא צריך לאשר אותה כדי ליצור את הקישור לסרטון שלו. אפשר לבטל בקשה שנשלחה לפני שהיא אושרה, ואפשר גם להסיר סרטון מקושר אחרי שהבקשה אושרה.
- היוצר של הסרטון מבקש לקשר את הסרטון לחשבון שלך ב-Google Ads. אחרי כן תוכלו לאשר או לדחות את הבקשה.
בכל תרחיש נעשה שימוש בשיטות הבאות:
| תרחיש | פעולה | הערות |
|---|---|---|
| תרחיש 1 | קבלת פרטי הסרטון מממשק YouTube API | משתמשים ב-YouTube API
כדי לקבל את channel_id שאליו צריך לשלוח את הבקשה לקישור הסרטון, או את video_id
של הסרטון שרוצים לקשר. אפשר גם לשלוף את video_id מכתובת ה-URL של סרטון. לשם כך, צריך לשלוף את 11 התווים שאחרי "v=". |
| יצירה של בקשת קישור | משתמשים ב-method
DataLinkService.CreateDataLink כדי ליצור בקשת קישור. אפשר גם לציין את youtube_video.channel_id כדי לזהות באופן מפורש את הערוץ שמשויך לסרטון, ואת youtube_link_metadata.brand_channel_id כדי לציין את המזהה של ערוץ המותג המקושר ב-YouTube, וכך לעזור ליוצרים להבין את המותג שלכם. הערך של
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 כדי לדחות אותה. |
אחזור פרטי קישור
אפשר להשתמש ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream כדי לשלוח שאילתה למשאב data_link.
השאילתה הבאה מאחזרת פרטים על קישורים לסרטונים ב-YouTube, כולל מזהה הערוץ ב-YouTube ומזהה ערוץ המותג המקושר ב-YouTube.
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
יכולות להיות שגיאות נפוצות בתהליך העבודה הזה:
| קוד שגיאה | הסבר |
|---|---|
DataLinkError.PERMISSION_DENIED |
ללקוח אין הרשאה לבצע את הפעולה הזו. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
לא ניתן ליצור קישור לסרטון כי מזהה הסרטון לא תקין. |