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