קישור ל-YouTube

‫Google Ads API תומך בקישור של סרטונים ב-YouTube לחשבון Google Ads. במדריך הזה מוסבר איך להשתמש ב-API כדי להוסיף קישורים לחשבון ולהסיר קישורים ממנו.

יש שתי דרכים לקשר סרטונים לחשבון שלכם, בהתאם למי שמתחיל את התהליך:

  1. אתם מבקשים לקשר סרטון לחשבון שלכם. בתרחיש הזה, אתם שולחים בקשה ליוצר, והוא צריך לאשר אותה כדי לקשר את הסרטון שלו. אתם יכולים לבטל בקשה להארכת זמן לפני שהיא אושרה, וגם להסיר סרטון מקושר אחרי שהבקשה אושרה.
  2. היוצר של הסרטון מבקש לקשר את הסרטון שלו לחשבון Google Ads שלכם. אחרי כן תוכלו לאשר או לדחות את הבקשה.

השיטות הבאות משמשות בכל תרחיש:

תרחיש פעולה הערות
תרחיש 1 קבלת פרטי הסרטון מממשק YouTube API ‫ממשק ה-API של YouTube מאפשר לקבל את המזהה channel_id של הערוץ שאליו רוצים לשלוח את הבקשה לקישור הסרטון, ואת המזהה video_id של הסרטון שרוצים לקשר. הפרמטר video_id הוא מחרוזת של 11 תווים שנמצאת בכתובות ה-URL של סרטונים ב-YouTube (לדוגמה, הפרמטר v בכתובת www.youtube.com/watch?v=VIDEO_ID או הנתיב בכתובת youtu.be/VIDEO_ID).
יצירה של בקשת קישור משתמשים בשיטה DataLinkService.CreateDataLink כדי ליצור בקשת קישור, ומציינים את הערכים youtube_video.channel_id ו-youtube_video.video_id כדי לזהות את הסרטון ואת הערוץ המשויך שלו. החל מגרסה 24, אפשר גם לציין את השדה youtube_link_metadata.brand_channel_id כדי לספק את המזהה של ערוץ המותג המקושר ב-YouTube, וכך לעזור ליוצרים להבין את המותג. הערך של status ב-DataLink לא צריך להיות מוגדר. השרת של Google Ads API יגדיר אותו ל-REQUESTED אחרי שהקריאה ל-API תושלם בהצלחה.
בדיקת הסטטוס של בקשה משתמשים ב-GoogleAdsService.SearchStream או ב-GoogleAdsService.Search כדי לשלוח שאילתה למשאב data_link ולבדוק את ה- status שלו.
ביטול בקשה משתמשים ב-method‏ DataLinkService.UpdateDataLink כדי לבטל בקשת קישור. לשם כך, משנים את הערך של status ב- DataLink מ-REQUESTED ל-REVOKED.
הסרת קישור כדי להסיר סרטון מקושר, לוחצים על DataLinkService.RemoveDataLink.
תרחיש 2 שליפת הזמנה משתמשים ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream כדי לשלוח שאילתה למשאב data_link. מסננים לפי status = PENDING_APPROVAL כדי למצוא בקשות קישור ולאשר או לדחות אותן.
אישור או דחייה של בקשת קישור משתמשים ב-method‏ DataLinkService.UpdateDataLink כדי לעדכן את הסטטוס של DataLink ל-ENABLED כדי לאשר את הבקשה או ל-REJECTED כדי לדחות אותה.

אחזור פרטי קישור

כדי לשלוח שאילתה למשאב data_link, אפשר להשתמש ב-GoogleAdsService.Search או ב-GoogleAdsService.SearchStream. השאילתה הבאה מאחזרת פרטים של קישורים לסרטונים ב-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 אי אפשר ליצור קישור לסרטון כי מזהה הסרטון לא תקין.
DataLinkError.INVALID_STATUS השגיאה הזו מופיעה כשהסטטוס הנוכחי של קישור הנתונים לא תקין לפעולה המבוקשת.
DataLinkError.INVALID_UPDATE_STATUS השגיאה הזו מופיעה כשמנסים לבצע שינוי סטטוס שלא נתמך במהלך עדכון (לדוגמה, מעבר ישירות מ-REVOKED ל-ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS השגיאה הזו מופיעה כשכבר קיים קישור נתונים לסרטון.
הקודם
קישור של חשבונות מוצרים
הבא
שינוי הסטטוס