שנתחיל?

Manufacturer Center API מאפשר לאפליקציות לבצע אינטראקציה ישירות עם פלטפורמת Manufacturer Center. כדי לעזור לך להתחיל, אנחנו מציעים דוגמאות קוד ב-Java וב-.NET.

המדריך הזה יעזור לך ליצור את האפליקציה הראשונה שלך באמצעות Manufacturer Center API. לפני שמתחילים לתכנת, יש כמה פעולות שצריך לעשות.

הגדרת חשבון Manufacturer Center

  1. יוצרים חשבון Manufacturer Center.
  2. חשוב לזכור את כתובת האימייל שבה השתמשת כדי ליצור את חשבון Manufacturer Center, כי יהיה עליך לעשות זאת מאוחר יותר. בצילומי המסך, יופיע הכיתוב manufacturer_user@example.com.

שולחים את בקשת ה-API הראשונה (בלי להזין קוד!)

  1. נכנסים ל-APIs Explorer במסמכי התיעוד למפתחים של Accounts.Products.list.
  2. מוודאים שחשבון Google שאליו אתם מחוברים מופיע בכרטיסייה ''משתמשים' בכרטיסייה 'הגדרות'.

  3. ב-APIs Explorer, יש לוודא שהאפשרות Google OAuth 2.0 נבחרה בתפריט הנפתח Authentication:

  4. מזינים accounts/{account_id} ומחליפים את {account_id} במזהה היצרן מחשבון Manufacturer Center, בשדה 'parent' בטופס ולוחצים על ביצוע.

    הערה: אם לא נתת בעבר הרשאת OAuth2, תישלח לך בקשה לאשר את השיחה.

  5. אמורה להופיע תגובה מוצלחת. כל הכבוד! שלחת את הבקשה הראשונה שלך ל-Manufacturer Center API.
  6. אם אין לכם עדיין מוצרים ב-Manufacturer Center, לא יופיעו אף מוצרים ברשימה. בשלב זה, אפשר לדלג על בקשות אחרות ולראות מה הן עובדות. מאחר שמדובר ב-API ל-REST, כל הבקשות פועלות באופן דומה. השלב הבא כשיהיה לך מוצרים, הוא לנסות את Accounts.Products.get.

יצירת פרויקט ב-Google API Console

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

הערה: אם אתם רוצים לבצע שיחות בשם לקוחות שיש להם חשבון Manufacturer Center משלהם, תוכלו להיעזר במדריך מתן הרשאה.

בקשת ה-API המורשה הראשונה שלך באמצעות Java

עכשיו, לאחר שהגדרת חשבון שירות והוספת את מספר חשבון השירות לחשבון Manufacturer Center שלך, יש לך אפשרות לגשת לחשבון באמצעות קוד לדוגמה. המדריך הזה משתמש בדוגמאות Java להדגמה באמצעות ה-API.

  1. מתקינים את Apache Maven, אם עוד לא עשיתם זאת.
  2. ניתן להוריד את הדוגמאות לדוגמה של שופינג מדף GitHub.

  3. מתוך ספריית המשנה java, יש לבנות את דוגמאות ה-Java:

    $ mvn compile
            

  4. עכשיו צריך להפעיל את הקוד ProductsListSample:

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            

  5. אם לא פעלת לפי הוראות ההגדרה ב-README הנלווים לקובצי המקור, תופיע הודעת שגיאה על כך שלא נמצאה הגדרה לדוגמה. צריך לפעול לפי ההוראות ברכיב README כדי ליצור את ספריית התצורה ולאכלס אותה במידע המתאים. קובץ ה-JSON שהורדת במהלך הגדרת חשבון השירות צריך להיות בספרייה הזו עם שם הקובץ service-account.json.

  6. עכשיו, לאחר שהגדרת את התצורה של דוגמאות, יש להריץ שוב את הקוד ProductsListSample.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            
  7. בשלב זה, תוכנית Java צריכה לסיים את ביצועה, ולהדפיס רשימה של מוצרים שהיא מצאה, או הודעה שלפיה לא היו מוצרים בחשבון שלך. אם מופיעה שגיאה כמו "User לא יכול לגשת לחשבון 1234567890", סביר להניח שהסיבה לכך היא שלא הגדרת את המשתמש של חשבון השירות כמשתמש מורשה ב-Manufacturer Center. מבחינת ה-API , פרויקט ה-API Console שלח בקשה בשם משתמש שלא היה רשום ברשימת מנהלי המערכת המורשים ב-Manufacturer Center, לכן כמובן שהוא דחה את הבקשה.

  8. אפשר לנסות להפעיל את ProductsListSample כמה פעמים שרוצים, כי זוהי בקשה לקריאה בלבד. אפשר גם לעיין בדוגמאות האחרות שיצרנו גם ל-Java וגם ל-NET.