קריאות ישירות ל-API

בגישה הזו לאינטראקציה עם Merchant API, שולחים בקשות גולמיות ישירות לנקודות הקצה של ה-API, בדרך כלל באמצעות HTTP(S). אתם מטפלים באופן ידני בהיבטים כמו יצירת גוף הבקשה, הגדרת כותרות (כולל אימות) וניתוח התגובה.

שלב 1. הירשם כמפתח

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

הרישום מאפשר לבצע את הפעולות הבאות:

  • יוצר איש קשר טכני לחשבון Merchant Center על ידי הקצאת התפקיד API developer למשתמש. כך Google יכולה לשלוח עדכונים חשובים שקשורים ספציפית ל-API ולתכונות שבהן המפתח משתמש, כמו הודעות על שירותים ומידע על תכונות חדשות, שעשויים להיות פחות מעניינים למשתמשים שאינם מפתחים.
  • האפשרות הזו מאפשרת לכם לעבוד עם כמה חשבונות מוכר בלי שתצטרכו להירשם כמה פעמים. כשאתם נרשמים, מספר הפרויקט ב-Google Cloud שמשמש לאימות ב-Merchant API משויך לחשבון Merchant Center שלכם, שבו מוגדרים אנשי הקשר הטכניים (API developer). כך תוכלו לקבל עדכונים חשובים לגבי כל חשבונות המוכרים שאתם מנהלים, כל עוד האימות מתבצע באמצעות פרויקט Google Cloud הרשום.

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

כדי להירשם באמצעות השיטה developerRegistration.registerGcp, אפשר להתחיל עם הדוגמה הזו ולהחליף את {DEVELOPER_EMAIL} בכתובת האימייל המתאימה בגוף הבקשה.

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

קריאה מוצלחת מחזירה משאב DeveloperRegistration, שמאשר את הקישור בין הפרויקט לחשבון.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

שלב 2. ניהול אנשי קשר והרשאות של מפתחים

כשנרשמים:

  • אם כתובת האימייל שייכת למשתמש בחשבון Merchant Center, למשתמש הזה מוקצה התפקיד API_DEVELOPER.
  • אם כתובת האימייל לא שייכת למשתמש קיים, נשלחת הזמנה לכתובת הזו. המקבל צריך לאשר את ההזמנה כדי להתווסף כמשתמש חדש עם התפקיד API_DEVELOPER.

אחרי הרישום הראשוני, מומלץ להוסיף כמה מפתחים ולהעניק להם זכויות גישה נוספות.

שלב 2א. מתן הרשאות נוספות

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

אפשר לעדכן את הרשאות הגישה של המשתמש באמצעות השיטה accounts.users.patch.

בדוגמה הבאה מוצג איך לעדכן משתמש כדי להעניק לו את התפקידים ADMIN ו-API_DEVELOPER. כך הם יוכלו לנהל את החשבון באופן מלא, והם גם יקבלו הודעות שקשורות ל-API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

שלב 2ב. הוספת מפתחים לגיבוי

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

אפשר להוסיף משתמש באמצעות השיטה accounts.users.create או לעדכן משתמש באמצעות השיטה accounts.users.patch. מומלץ להקצות למשתמש הזה את התפקידים ADMIN ו-API_DEVELOPER.

שלב 3. יצירת מקור ראשי של נתוני מוצרים

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

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

מחליפים את {ACCOUNT_ID} במספר החשבון של Merchant Center שיצרתם.

אחרי שהבקשה תופעל בהצלחה, תופיע התגובה הבאה:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

מעתיקים את הערך של השדה name. תצטרכו אותו כדי להוסיף מוצר.

אפשר לראות את מקור הנתונים הזה בממשק המשתמש של Merchant Center. מידע נוסף מופיע במאמר איך ניגשים לכרטיסייה 'מקורות נתונים'.

שלב 4. הוסף מוצר

אחרי שיוצרים את מקור הנתונים, מנסים להוסיף אליו מוצר. מריצים את הפקודה הבאה ומזינים את ACCOUNT_ID הנכון. מחליפים את {DATASOURCE_NAME} בערך שהעתקתם קודם.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

אחרי שהבקשה תופעל בהצלחה, תופיע התגובה הבאה:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "brand": "New brand",
    "gender": "MALE"
  }
}

מזהה המוצר של המוצר החדש שנוצר הוא en~US~tshirt-123. אפשר להשתמש בשיטה accounts.products.get כדי לאחזר פרטים על המוצר הזה. אפשר גם להשתמש בממשק המשתמש של Merchant Center כדי לראות את המוצר הזה. איך מעיינים בנתוני המוצרים

הקודם
Overview
הבא
Client libraries