שנתחיל?

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

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

תמיכת REST

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

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

הגדרת חשבון 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 בשדה 'הורה' שבטופס ולוחצים על ביצוע.

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

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

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

בקשות ל-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 (לדוגמה, Productהסמכות יהיה קוד 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.