הגדרה טכנית

לפני שמתחילים

לפני שמתחילים, צריך:

• גישת סופר-אדמין לדומיין של המפיץ. מידע נוסף זמין במאמר בנושא גישה ל-Cloud Channel API.

• גישה למסוף Google Cloud ולתוכנית המכירות של שותפי YouTube.

שלב 1: הכנת מסוף תוכנית המכירות של שותפי YouTube

כדי להשתמש ב-API, צריך לאשר את התנאים וההגבלות של פלטפורמת שירותי הערוצים.

מתחברים ל-Partner Sales Console לפחות פעם אחת כאדמינים של דומיין המפיץ. בפעם הראשונה שמתחברים, צריך לאשר את התנאים וההגבלות של המפיץ, אם רלוונטי. אם אישרתם תנאים והגבלות ספציפיים אופליין, השלב הזה לא רלוונטי עבורכם.

אפשר לאשר תנאים והגבלות נוספים בדף התנאים במסוף תוכנית המכירות של שותפי YouTube.

הערה: כדי לבצע שילוב של API, צריך את מספר החשבון שמופיע בדף ההגדרות של Partner Sales Console.

שלב 2: הגדרת הפרויקט Google Cloud

כדי להשתמש בממשק Google API כלשהו, צריך שיהיה לכם Google Cloud פרויקט.

יצירת Google Cloud פרויקט

כדי ליצור פרויקט, עוברים לאזור Projects (פרויקטים) במסוף Google Cloud ולוחצים על Create Project (יצירת פרויקט).

הוראות מפורטות ליצירת פרויקט ורשימה של שיטות מומלצות זמינות במדריך יצירה וניהול של פרויקטים.

רוב המפיצים יוצרים Google Cloud פרויקטים בארגון הראשיGoogle Cloud שלהם ולא בדומיין של המפיץ. הגישה לנתונים מהדומיין של המפיץ ניתנת על ידי הגדרת הענקת גישה ברמת הדומיין כדי לאפשר לחשבון שירות לגשת לנתונים מהדומיין של המפיץ.

נותנים לפרויקט שם תיאורי. מזהה הפרויקט הוא מזהה שרירותי שלא משפיע על היכולת שלכם להפעיל את Cloud Channel API.

הפעלת ה-API

נכנסים לקטע API Library במסוף Google Cloud ומפעילים את Cloud Channel API.

יצירה של חשבון שירות

כדי ליצור את חשבון השירות, עוברים לדף Service accounts.

כניסה לדף Service accounts

הערה: אם לא מנהלים כראוי את המפתחות לחשבונות השירות הם עלולים לסכן את האבטחה. כשזה אפשרי, מומלץ לבחור שיטה מאובטחת יותר ממפתחות של חשבונות שירות. אם אתם מוכרחים לבצע אימות באמצעות מפתח של חשבון שירות, באחריותכם לאבטח את המפתח הפרטי ולבצע פעולות אחרות שמתוארות במאמר שיטות מומלצות לניהול מפתחות לחשבונות שירות. אם אין לכם אפשרות ליצור מפתח לחשבון שירות, יכול להיות שהיצירה של מפתחות לחשבון שירות מושבתת בארגון שלכם. מידע נוסף זמין במאמר בנושא ניהול משאבי ארגון שמוגדרים כמאובטחים כברירת מחדל.

אם קיבלתם את המפתח של חשבון השירות ממקור חיצוני, אתם צריכים לאמת אותו לפני השימוש. מידע נוסף זמין במאמר בנושא דרישות אבטחה לגבי אישורים ממקורות חיצוניים.

1. לוחצים על Create Service Account (יצירת חשבון שירות).
2. מזינים את שם חשבון השירות (ואת תיאור חשבון השירות האופציונלי) ואז לוחצים על יצירה.
3. לוחצים על Continue כדי לדלג על האפשרות Grant service account access to project (הענקת גישה לחשבון השירות לפרויקט).
4. מדלגים על הקטע Grant users access to this service account (הענקת גישה לחשבון השירות הזה) ולוחצים על Done (סיום) כדי לסיים את יצירת החשבון.

אחרי שיוצרים את החשבון, יוצרים מפתח לחשבון השירות:

1. במסוף Cloud, לוחצים על כתובת האימייל של חשבון השירות שיצרתם. Google Cloud
2. לוחצים על Keys.
3. לוחצים על Add key ואז על Create new key.

4. לוחצים על יצירה. למחשב שלכם תתבצע הורדה של קובץ JSON עם המפתח.

   חשוב לאחסן את קובץ המפתח באופן מאובטח כי הוא יכול לשמש לצורך אימות כחשבון השירות שלכם. אפשר להעביר את הקובץ לאן שרוצים ולשנות את השם שלו למה שרוצים.

5. לוחצים על Close.

אפשר למחוק וליצור קובצי מפתח פרטי בדף 'חשבונות שירות'.

שלב 3: מתן הרשאה לחשבון השירות בדומיין של המפיץ

בקטע הזה צריך להזין את מזהה הלקוח של חשבון השירות. בתפריט פעולות, בוחרים באפשרות ניהול פרטים ומעתיקים את המספר הייחודי.

עוברים אל הדף 'הענקת גישה ברמת הדומיין' באמצעות חשבון סופר-אדמין בדומיין של המפיץ.

• לוחצים על Add new (הוספת חדש) ומזינים את המזהה של חשבון השירות בשדה Client ID (מזהה לקוח).
• מזינים https://www.googleapis.com/auth/apps.order בשדה OAuth Scopes (היקף ההרשאות ל-OAuth).
• לוחצים על Authorize (אישור) כדי לאפשר לחשבון השירות להשתמש ב-Cloud Channel API בהקשר של חשבון Channel Services.

הערה: אם אתם משתמשים בממשקי API נוספים בשילוב הסופי, יכול להיות שיהיה יותר מהיקף אחד ללקוח של חשבון השירות.

לאחר מכן לוחצים על Authorize (אישור) כדי שחשבון השירות יוכל להשתמש ב-Cloud Channel API בהקשר של חשבון Channel Services.

הערה: יכול להיות שתצטרכו להפעיל עוד ממשקי API ולהוסיף עוד היקפי הרשאות ב-codelabs אחרים. יכול להיות שבשילוב הסופי יהיו יותר מהיקף אחד ללקוח של חשבון השירות.

השלבים הבאים

אחרי שיצרתם שילוב טכני ראשוני, תוכלו לקרוא את מאמרי העזרה של Cloud Channel API כדי להכיר את ה-API.

הערה: אם יש לכם גם מסוף תוכנית המכירות של שותפי YouTube לבדיקה, צריך לבצע את שלבים 1 עד 4 עם הדומיין של המפיץ לבדיקה. חשוב ליצור פרויקט נפרד כי לממשקי Google API יש מכסות לכל פרויקט. שיתוף פרויקט בין סביבות עלול לגרום לחשבונות הבדיקה להשפיע על המכסות בחשבון הייצור.