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.
list GET /accounts/v1beta/accounts
רשימת חשבונות שאפשר לגשת אליהם רק אם המשתמש שמתקשר יכול להתאים למגבלות של הבקשה, כמו גודל הדף או מסננים.
listSubaccounts GET /accounts/v1beta/{provider=accounts/*}:listSubaccounts
להציג רשימה של כל חשבונות המשנה של חשבון מרובה לקוחות מסוים.
patch PATCH /accounts/v1beta/{account.name=accounts/*}
מעדכנים את החשבון ללא קשר לסוג שלו: חשבון עצמאי, חשבון MCA או חשבון משנה.

משאב REST: accounts_v1beta.accounts.businessIdentity

שיטות
getBusinessIdentity GET /accounts/v1beta/{name=accounts/*/businessIdentity}
אחזור של זהות העסק של החשבון.
updateBusinessIdentity PATCH /accounts/v1beta/{businessIdentity.name=accounts/*/businessIdentity}
עדכון של זהות העסק בחשבון.

משאב REST: accounts_v1beta.accounts.businessInfo

שיטות
getBusinessInfo GET /accounts/v1beta/{name=accounts/*/businessInfo}
אחזור של פרטי העסק של חשבון.
updateBusinessInfo PATCH /accounts/v1beta/{businessInfo.name=accounts/*/businessInfo}
עדכון פרטי העסק של החשבון.

משאב REST: accounts_v1beta.accounts.emailpreferences

שיטות
getEmailPreferences GET /accounts/v1beta/{name=accounts/*/users/*/emailPreferences}
הפונקציה מחזירה את העדפות האימייל של משתמש בחשבון Merchant Center.
updateEmailPreferences PATCH /accounts/v1beta/{emailPreferences.name=accounts/*/users/*/emailPreferences}
מעדכן את העדפות האימייל של משתמש בחשבון Merchant Center.

משאב REST: accounts_v1beta.accounts.homepage

שיטות
claim POST /accounts/v1beta/{name=accounts/*/homepage}:claim
תביעת בעלות על דף הבית של חנות.
getHomepage GET /accounts/v1beta/{name=accounts/*/homepage}
אחזור דף הבית של חנות.
unclaim POST /accounts/v1beta/{name=accounts/*/homepage}:unclaim
מבטל את תביעת הבעלות על דף הבית של חנות.
updateHomepage PATCH /accounts/v1beta/{homepage.name=accounts/*/homepage}
מעדכן את דף הבית של חנות.

משאב 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

שיטות
getShippingSettings GET /accounts/v1beta/{name=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.
list GET /accounts/v1beta/{parent=accounts/*}/users
רשימה של כל המשתמשים בחשבון Merchant Center.
patch PATCH /accounts/v1beta/{user.name=accounts/*/users/*}
עדכון משתמש בחשבון 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 נתונים.