מתחילים

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

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

תמיכה ב-REST

ה-API ל-REST תומך בפעולות CRUD בסיסיות עבור 2 סוגי משאבים שונים:

שאר המסמכים האלה ייכתבו בעיקר עבור Product, אבל התהליך צריך להיות דומה לתהליך ProductCertification.

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

  1. יוצרים חשבון Manufacturer Center.

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

יצירת בקשת API ראשונה (בלי שורת קוד!)

  1. מעבר אל APIs Explorer במסמכי התיעוד למפתחים בנושא Accounts.Products.list.

  2. מוודאים שחשבון Google שמחובר לחשבון מופיע בהגדרה 'משתמשים' בכרטיסייה Settings (הגדרות).

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

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

  5. אתם אמורים לראות תגובה מוצלחת. כל הכבוד! שלחתם את הבקשה הראשונה שלכם ל-Manufacturer Center API.

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

יצירת פרויקט במסוף Google API

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

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

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

  1. מתקינים את Apache Maven, אם עוד לא עשיתם זאת.

  2. מורידים את דוגמאות לשופינג מהדף שלנו ב-GitHub.

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

    $ mvn compile

  4. עכשיו מריצים את הקוד ProductsListSample (הדוגמה לProductCertification היא ListProductCertificationsSample):

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

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

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

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

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

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

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