Merchant API

לנהל באופן פרוגרמטי את חשבונות Merchant Center.

שירות: merchantapi.googleapis.com

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

מסמך Discovery

מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולשימוש של ממשקי API בארכיטקטורת REST. אפשר להשתמש בו כדי ליצור ספריות לקוח, יישומי פלאגין של סביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד עשוי לספק כמה מסמכי גילוי. השירות הזה מספק את מסמכי הגילוי הבאים:

נקודת קצה (endpoint) של שירות

נקודת קצה (endpoint) של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoint) של שירות. השירות הזה כולל את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI שבהמשך הם יחסיים לנקודת הקצה הזו של השירות:

  • https://merchantapi.googleapis.com

משאב REST: reports_v1beta.accounts.reports

שיטות
search POST /reports/v1beta/{parent=accounts/*}/reports:search
אחזור של דוח שהוגדר על ידי שאילתת חיפוש.

משאב ב-REST: quota_v1beta.accounts.quotas

שיטות
list GET /quota/v1beta/{parent=accounts/*}/quotas
בעמודה הזו מפורטים מכסת השיחות היומית והשימוש בכל קבוצה בחשבון Merchant Center שלכם.

משאב REST: promotions_v1beta.accounts.promotions

שיטות
get GET /promotions/v1beta/{name=accounts/*/promotions/*}
מתבצע אחזור של המבצע מחשבון Merchant Center.
insert POST /promotions/v1beta/{parent=accounts/*}/promotions:insert
הוספת מבצע לחשבון Merchant Center.
list GET /promotions/v1beta/{parent=accounts/*}/promotions
רשימת המבצעים בחשבון Merchant Center שלך.

משאב ב-REST: products_v1beta.accounts.productInputs

שיטות
delete DELETE /products/v1beta/{name=accounts/*/productInputs/*}
מחיקת קלט של מוצר מחשבון Merchant Center.
insert POST /products/v1beta/{parent=accounts/*}/productInputs:insert
מעלה קלט של מוצר לחשבון Merchant Center.

משאב ב-REST: products_v1beta.accounts.products

שיטות
get GET /products/v1beta/{name=accounts/*/products/*}
אחזור של המוצר המעובד מחשבון Merchant Center שלך.
list GET /products/v1beta/{parent=accounts/*}/products
פירוט המוצרים המעובדים בחשבון Merchant Center שלכם.

משאב REST: notifications_v1beta.accounts.notificationsubscriptions

שיטות
create POST /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
יצירת מינוי להתראות בשביל המוכר.
delete DELETE /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
מחיקת המינוי להתראות של המוכר.
get GET /notifications/v1beta/{name=accounts/*/notificationsubscriptions/*}
קבלת התראות על מינויים לחשבון.
list GET /notifications/v1beta/{parent=accounts/*}/notificationsubscriptions
קבלת כל המינויים להתראות של מוכר.
patch PATCH /notifications/v1beta/{notificationSubscription.name=accounts/*/notificationsubscriptions/*}
עדכון מינוי קיים להתראות של המוכר.

משאב REST: lfp_v1beta.accounts.lfpInventories

שיטות
insert POST /lfp/v1beta/{parent=accounts/*}/lfpInventories:insert
מוסיף משאב LfpInventory לחשבון מוכר היעד הנתון.

משאב REST: lfp_v1beta.accounts.lfpSales

שיטות
insert POST /lfp/v1beta/{parent=accounts/*}/lfpSales:insert
מוסיף LfpSale למוכר הנתון.

משאב REST: lfp_v1beta.accounts.lfpStores

שיטות
delete DELETE /lfp/v1beta/{name=accounts/*/lfpStores/*}
מחיקת חנות של מוכר יעד.
get GET /lfp/v1beta/{name=accounts/*/lfpStores/*}
אחזור מידע על חנות.
insert POST /lfp/v1beta/{parent=accounts/*}/lfpStores:insert
הוספת חנות למוכר היעד.
list GET /lfp/v1beta/{parent=accounts/*}/lfpStores
רשימה של החנויות של מוכר היעד, שצוינו על ידי המסנן בListLfpStoresRequest.

משאב REST: inventories_v1beta.accounts.products.localInventories

שיטות
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/localInventories/*}
מחיקת הערך LocalInventory שצוין מהמוצר הנתון בחשבון המוכר שלכם.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/localInventories:insert
הוספת משאב LocalInventory למוצר בחשבון המוכר שלך.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/localInventories
פירוט המשאבים LocalInventory של המוצר הנתון בחשבון המוכר שלכם.

משאב REST: inventories_v1beta.accounts.products.regionalInventories

שיטות
delete DELETE /inventories/v1beta/{name=accounts/*/products/*/regionalInventories/*}
מחיקת המשאב RegionalInventory שצוין מהמוצר הנתון בחשבון המוכר שלכם.
insert POST /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories:insert
הוספת RegionalInventory למוצר נתון בחשבון המוכר שלך.
list GET /inventories/v1beta/{parent=accounts/*/products/*}/regionalInventories
פירוט המשאבים RegionalInventory של המוצר הנתון בחשבון המוכר שלכם.

משאב ב-REST: datasources_v1beta.accounts.dataSources

שיטות
create POST /datasources/v1beta/{parent=accounts/*}/dataSources
יצירת ההגדרה החדשה של מקור הנתונים לחשבון הנתון.
delete DELETE /datasources/v1beta/{name=accounts/*/dataSources/*}
מחיקת מקור נתונים מחשבון Merchant Center שלכם.
fetch POST /datasources/v1beta/{name=accounts/*/dataSources/*}:fetch
השירות מבצע אחזור נתונים באופן מיידי (גם מחוץ לתזמון השליפה) במקור נתונים מחשבון Merchant Center.
get GET /datasources/v1beta/{name=accounts/*/dataSources/*}
אחזור ההגדרות של מקור הנתונים לחשבון הנתון.
list GET /datasources/v1beta/{parent=accounts/*}/dataSources
פירוט ההגדרות של מקורות הנתונים של החשבון הנתון.
patch PATCH /datasources/v1beta/{dataSource.name=accounts/*/dataSources/*}
עדכון ההגדרה הקיימת של מקור הנתונים.

משאב ב-REST: conversions_v1beta.accounts.conversionSources

שיטות
create POST /conversions/v1beta/{parent=accounts/*}/conversionSources
יצירת מקור המרות חדש.
delete DELETE /conversions/v1beta/{name=accounts/*/conversionSources/*}
העברה לארכיון של מקור המרות קיים.
get GET /conversions/v1beta/{name=accounts/*/conversionSources/*}
מאחזר מקור המרות.
list GET /conversions/v1beta/{parent=accounts/*}/conversionSources
אחזור הרשימה של מקורות ההמרות שלמבצע הקריאה החוזרת יש גישה אליהם.
patch PATCH /conversions/v1beta/{conversionSource.name=accounts/*/conversionSources/*}
עדכון המידע של מקור המרות קיים.
undelete POST /conversions/v1beta/{name=accounts/*/conversionSources/*}:undelete
הפעלה מחדש של מקור המרות שהועבר לארכיון.

משאב REST: accounts_v1beta.accounts

שיטות
createAndConfigure POST /accounts/v1beta/accounts:createAndConfigure
יצירת חשבון Merchant Center עצמאי עם הגדרות נוספות.
delete DELETE /accounts/v1beta/{name=accounts/*}
מחיקת החשבון שצוין, ללא קשר לסוג שלו: עצמאי, חשבון MCA או חשבון משנה.
get GET /accounts/v1beta/{name=accounts/*}
אחזור של חשבון מחשבון Merchant Center.
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
אחזור של זהות העסק של החשבון.
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
אחזור של פרטי העסק של החשבון.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
אחזור דף הבית של חנות.
getShippingSettings GET /accounts/v1beta/{name=accounts/*/shippingSettings}
אחזור פרטים של הגדרות משלוח.
list GET /accounts/v1beta/accounts
רשימת החשבונות שיש להם גישה למשתמש ששלח את הקריאה, והתאמה למגבלות הבקשה, כמו גודל הדף או המסננים.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
רשימה של כל חשבונות המשנה של חשבון מרובה לקוחות מסוים.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
עדכון החשבון ללא קשר לסוג שלו: חשבון עצמאי, חשבון MCA או חשבון משנה.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
עדכון זהות העסק של החשבון.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
עדכון פרטי העסק של החשבון.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
עדכון דף הבית של חנות.

משאב REST: accounts_v1beta.accounts.accounttax

שיטות
get GET /accounts/v1beta/{name=accounts/*/accounttax/*}
הפונקציה מחזירה את כללי המס שתואמים לתנאים של GetAccountTaxRequest
list GET /accounts/v1beta/{parent=accounts/*}/accounttax
מפרט את הגדרות המס של חשבונות המשנה רק בחשבון Merchant Center שלך.
patch PATCH /accounts/v1beta/{accountTax.name=accounts/*/accounttax/*}
עדכון הגדרות המס של החשבון.

משאב REST: accounts_v1beta.accounts.homepage

שיטות
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
תביעת בעלות על דף הבית של חנות.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
ביטול הבעלות על דף הבית של חנות.

משאב REST: accounts_v1beta.accounts.issues

שיטות
list GET /accounts/v1beta/{parent=accounts/*}/issues
פירוט כל הבעיות בחשבון Merchant Center.

משאב REST: accounts_v1beta.accounts.onlineReturnPolicies

שיטות
get GET /accounts/v1beta/{name=accounts/*/onlineReturnPolicies/*}
קבלת מדיניות החזרת מוצרים קיימת.
list GET /accounts/v1beta/{parent=accounts/*}/onlineReturnPolicies
כאן רשומים כל כללי מדיניות החזרת המוצרים הקיימים.

משאב REST: accounts_v1beta.accounts.programs

שיטות
disable POST /accounts/v1beta/{name=accounts/*/programs/*}:disable
להשבית את ההשתתפות בתוכנית שצוינה בחשבון.
enable POST /accounts/v1beta/{name=accounts/*/programs/*}:enable
הפעלת ההשתתפות בתוכנית בחשבון שצוינה.
get GET /accounts/v1beta/{name=accounts/*/programs/*}
אחזור של התוכנית שצוינה בחשבון.
list GET /accounts/v1beta/{parent=accounts/*}/programs
אחזור כל התוכניות של החשבון.

משאב REST: accounts_v1beta.accounts.regions

שיטות
create POST /accounts/v1beta/{parent=accounts/*}/regions
הפונקציה הזו יוצרת הגדרת אזור בחשבון Merchant Center שלכם.
delete DELETE /accounts/v1beta/{name=accounts/*/regions/*}
הגדרת אזור תימחק מחשבון Merchant Center שלכם.
get GET /accounts/v1beta/{name=accounts/*/regions/*}
אחזור של אזור שהוגדר בחשבון Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/regions
מציינים את האזורים בחשבון Merchant Center.
patch PATCH /accounts/v1beta/{region.name=accounts/*/regions/*}
עדכון הגדרת האזור בחשבון Merchant Center.

משאב REST: accounts_v1beta.accounts.shippingSettings

שיטות
insert POST /accounts/v1beta/{parent=accounts/*}/shippingSettings:insert
מחליפים את הגדרת המשלוח של המוכר בהגדרת המשלוח של הבקשה.

משאב REST: accounts_v1beta.accounts.termsOfServiceAgreementStates

שיטות
get GET /accounts/v1beta/{name=accounts/*/termsOfServiceAgreementStates/*}
מחזירה את המצב של הסכם התנאים וההגבלות.
retrieveForApplication GET /accounts/v1beta/{parent=accounts/*}/termsOfServiceAgreementStates:retrieveForApplication
אחזור של מצב ההסכם של התנאים וההגבלות של האפליקציה.

משאב REST: accounts_v1beta.accounts.users

שיטות
create POST /accounts/v1beta/{parent=accounts/*}/users
יצירת משתמש בחשבון Merchant Center.
delete DELETE /accounts/v1beta/{name=accounts/*/users/*}
מחיקת משתמש בחשבון Merchant Center.
get GET /accounts/v1beta/{name=accounts/*/users/*}
אחזור של משתמש בחשבון Merchant Center.
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
מחזירה את העדפות האימייל של משתמש בחשבון Merchant Center.
list GET /accounts/v1beta/{parent=accounts/*}/users
רשימה של כל המשתמשים בחשבון Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
עדכון משתמש בחשבון Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
עדכון העדפות האימייל של משתמש בחשבון Merchant Center.

משאב REST: accounts_v1beta.termsOfService

שיטות
accept GET /accounts/v1beta/{name=termsOfService/*}:accept
מקבלים TermsOfService.
get GET /accounts/v1beta/{name=termsOfService/*}
אחזור של נתוני TermsOfService שמשויכים לגרסה שסופקה.
retrieveLatest GET /accounts/v1beta/termsOfService:retrieveLatest
אחזור הגרסה האחרונה של TermsOfService של kind ו-region_code נתונים.