קישור ל-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).
	יצירה של בקשת קישור	משתמשים ב-method‏ 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 כדי לדחות אותה.

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

אפשר להשתמש ב-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	השגיאה הזו מופיעה כשכבר קיים קישור נתונים לסרטון.