קישור ל-YouTube

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

קישור סרטונים

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

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

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

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