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 שלו. |
|
| ביטול בקשה | כדי לבטל בקשת קישור, משנים את הערך של status ב-
DataLink מ-REQUESTED ל-REVOKED באמצעות השיטה
DataLinkService.UpdateDataLink. |
|
| הסרת קישור | כדי להסיר סרטון מקושר, מקישים על
DataLinkService.RemoveDataLink. |
|
| תרחיש 2 | אחזור הזמנה | משתמשים ב-GoogleAdsService.Search
או ב-GoogleAdsService.SearchStream
כדי לשלוח שאילתה למשאב data_link. מסננים לפי
status = PENDING_APPROVAL כדי למצוא בקשות קישור
כדי לאשר או לדחות. |
| אישור או דחייה של בקשת קישור | משתמשים ב-method
DataLinkService.UpdateDataLink כדי לעדכן את הסטטוס של DataLink ל-ENABLED כדי לאשר את הבקשה או ל-REJECTED כדי לדחות אותה. |
אלה השגיאות הנפוצות שעשויות להתרחש בתהליך העבודה הזה:
| קוד שגיאה | הסבר |
|---|---|
DataLinkError.PERMISSION_DENIED |
ללקוח אין הרשאה לבצע את הפעולה הזו. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
לא ניתן ליצור קישור לסרטון כי מזהה הסרטון לא תקין. |