העברת תמיכה למוֹכרים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בעזרת Content API for Shopping, אפשר להשתמש במשאב merchantsupport כדי ליצור דף אבחון בתוך האפליקציה בשביל המוכרים. Merchant API מציע פתרון בעיות, שתומך באותה פונקציונליות.
סקירה כללית
כשמבצעים מיגרציה מ-Content API, צריך לשים לב לשינויים הבאים בשמות ובמבנים של השירותים והשיטות:
- השינוי המשמעותי ביותר בתגובת ה-API הוא איחוד האובייקטים
AccountIssue ו-ProductIssue לאובייקט אחד RenderedIssue. הפעולה הזו אמורה לפשט את הקוד על ידי יצירת מבנה עקבי לכל סוגי הבעיות.
- ב-Merchant API, השדה
issues נקרא עכשיו rendered_issues.
מזהים
כדי להשתמש ב-Merchant API, צריך לשנות את המזהים של Content API באופן הבא.
| שיטה |
Content API for Shopping |
Merchant API |
renderaccountissues |
{merchant_id} |
accounts/{ACCOUNT_ID} |
renderproductissues |
{PRODUCT_ID} |
accounts/{ACCOUNT_ID}/products/{PRODUCT_ID} |
TriggerAction |
{merchant_id} |
accounts/{ACCOUNT_ID} |
בקשות
כדי להשתמש ב-Merchant API, צריך לשנות את הבקשות של Content API באופן הבא.
| פעולה |
Content API for Shopping |
Merchant API |
| הצגת בעיות ברמת החשבון |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/renderaccountissues
|
POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID:renderaccountissues
|
| בעיות בעיבוד של מוצר |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/renderproductissues/PRODUCT_ID
|
POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID/products/PRODUCT_ID:renderproductissues
|
| פעולת טריגר |
POST https://shoppingcontent.googleapis.com/content/v2.1/MERCHANT_ID/merchantsupport/triggeraction
|
https://merchantapi.googleapis.com/issueresolution/v1/accounts/ACCOUNT_ID:triggeraction
|
השינוי המשמעותי ביותר בתגובת ה-API הוא איחוד האובייקטים AccountIssue ו-ProductIssue לאובייקט RenderedIssue יחיד.
הפעולה הזו אמורה לפשט את הקוד על ידי יצירת מבנה עקבי לכל סוגי הבעיות.
שדות ששמם שונה
השם החדש של השדה issues ברמה העליונה בתשובה הוא renderedIssues. הוא מכיל רשימה של RenderedIssue אובייקטים.
| Content API for Shopping |
Merchant API |
issues |
renderedIssues |
מודלים ששמם שונה
| Content API for Shopping |
Merchant API |
|
RenderedIssue |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-08 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-08 (שעון UTC)."],[],[],null,["# Migrate merchant support\n\nWith Content API for Shopping, you can use the\n[merchantsupport](/shopping-content/reference/rest/v2.1/merchantsupport)\nresource to create an in-app diagnostics page for your merchants. Merchant API\noffers Issue resolution, which supports the same functionality.\n\nOverview\n--------\n\nWhen migrating from Content API, observe the following that there are changes to\nthe service and method names and structures:\n\n- The most significant change in the API response is the consolidation of the `AccountIssue` and `ProductIssue` objects into a single `RenderedIssue` object. This should simplify your code by providing a consistent structure for all types of issues.\n- Merchant API renames the `issues` field as `rendered_issues`.\n\nIdentifiers\n-----------\n\nChange your Content API identifiers as follows for Merchant API.\n\n| Method | Content API for Shopping | Merchant API |\n|-----------------------|--------------------------|-----------------------------------------------|\n| `renderaccountissues` | `{merchant_id}` | `accounts/{ACCOUNT_ID}` |\n| `renderproductissues` | `{PRODUCT_ID}` | `accounts/{ACCOUNT_ID}/products/{PRODUCT_ID}` |\n| `TriggerAction` | `{merchant_id}` | `accounts/{ACCOUNT_ID}` |\n\nRequests\n--------\n\nChange your Content API requests as follows for Merchant API.\n\n| Action | Content API for Shopping | Merchant API |\n|--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Render account level issues for an account | ` POST https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`/merchantsupport/renderaccountissues ` | ` POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/`\u003cvar translate=\"no\"\u003eACCOUNT_ID\u003c/var\u003e`:renderaccountissues ` |\n| Render issues for a product | ` POST https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`/merchantsupport/renderproductissues/`\u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e` ` | ` POST https://merchantapi.googleapis.com/issueresolution/v1/accounts/`\u003cvar translate=\"no\"\u003eACCOUNT_ID\u003c/var\u003e`/products/`\u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e`:renderproductissues ` |\n| Trigger action | ` POST https://shoppingcontent.googleapis.com/content/v2.1/`\u003cvar translate=\"no\"\u003eMERCHANT_ID\u003c/var\u003e`/merchantsupport/triggeraction ` | ` https://merchantapi.googleapis.com/issueresolution/v1/accounts/`\u003cvar translate=\"no\"\u003eACCOUNT_ID\u003c/var\u003e`:triggeraction ` |\n\nThe most significant change in the API response is the consolidation of\n`AccountIssue` and `ProductIssue` objects into a single `RenderedIssue` object.\nThis should simplify your code by providing a consistent structure for all types\nof issues.\n\nRenamed fields\n--------------\n\nThe new name for the top-level `issues` field in the response is\n`renderedIssues`. It contains a list of `RenderedIssue` objects.\n\n| Content API for Shopping | Merchant API |\n|--------------------------|------------------|\n| `issues` | `renderedIssues` |\n\nRenamed models\n--------------\n\n| Content API for Shopping | Merchant API |\n|-----------------------------------|-----------------|\n| - `AccountIssue` - `ProductIssue` | `RenderedIssue` |"]]
