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