קריאות ישירות ל-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. כדי לאחזר פרטים על המוצר הזה, אפשר להשתמש ב-method‏ accounts.products.get. אפשר גם להשתמש בממשק המשתמש של Merchant Center כדי לראות את המוצר הזה. איך רואים את נתוני המוצרים ב-Merchant Center