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 כדי לזהות במדויק את הערוץ שמשויך לסרטון. הערך של
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.
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 |
לא הצלחנו ליצור קישור לסרטון כי מזהה הסרטון לא תקין. |