Merchant API MCP Access Service (אלפא)

אפשר להשתמש בשירות הגישה Model Context Protocol‏ (MCP) של Merchant API כדי לקבל גישה מורשית לנתונים ולתובנות ב-Merchant Center, וכך ליצור פעולות חדשות מבוססות-AI ותהליכי עבודה אוטומטיים.

סקירה כללית

שירות הגישה ל-MCP של Merchant API מספק גשר מאובטח וסטנדרטי למודלים גדולים של שפה (LLM), לסוכנים ולעוזרי קידוד, כדי ליצור ולתזמר חוויות חדשות מבוססות-סוכנים ותהליכי עבודה אוטומטיים שמבוססים על נתונים מ-Merchant Center.

באופן ספציפי, הוא מאפשר גישה מורשית לנתונים שלכם ב-Merchant Center ולדוחות ולתובנות שנוצרו על ידי Google, כדי לבצע פעולות קריאה בלבד וכתיבה מוגבלת לטיפול בתרחישי שימוש כמו:

  • אבחון ותיקון של פסילות מוצרים
  • יצירת דוחות ביצועים ותובנות
  • בדיקת ההסכמה להפעלת שיפורים אוטומטיים
  • יצירה ואחזור של מקורות נתונים

אמצעי בקרה לגישה ולאבטחה

שירות הגישה ל-MCP של Merchant API מתוכנן עם דגש על אבטחה:

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

שיקולים חשובים

השירות Merchant API MCP Access הוא גרסת אלפא. ההיקף והיכולות שלו יורחבו ועשויים להשתנות.

לפני שמתחילים, חשוב לקרוא את המגבלות הבאות ואת השיטות המומלצות:

שינויים וגרסאות

יכולים להיות שינויים ללא הודעה מוקדמת, והם יפורסמו בהערות לגבי הגרסה.

בדיקות בטוחות

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

מכסה משותפת

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

סינון ובטיחות של כלים

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

סיכום היכולות הזמינות

אתם יכולים להשתמש ב-Merchant API MCP Access Service כדי לבצע את הפעולות הבאות בצורה אוטונומית:

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

תחילת העבודה

כדי לחבר את סביבת הפיתוח המשולבת (IDE), העוזר האישי לתכנות או הסוכן שלכם לשירות הגישה ל-MCP של Merchant API, צריך לעדכן את הגדרות הלקוח של MCP. לדוגמה, צריך לעדכן את קובץ mcp.json עבור Google Agent Studio,‏ Claude Desktop,‏ Antigravity,‏ Visual Studio Code או מסגרת הסוכן המותאמת אישית שלכם.

ההגדרה של שירות הגישה של Merchant API MCP המקומי דורשת חשבון שירות. לא ניתן להשתמש ב-OAuth של משתמש רגיל בהרצה מקומית ללא ממשק משתמש. אתם צריכים ליצור חשבון שירות, להוריד את קובץ מפתח ה-JSON הפרטי שלו ולספק את הנתיב אליו יחד עם מספר חשבון Merchant Center הספציפי שלכם כארגומנטים.

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

הגדרת לקוח

הגדרות תצורה:

Antigravity

פועלים לפי ההוראות במסמכי Antigravity.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

פועלים לפי ההוראות בתיעוד של Claude Desktop.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

תרחישים לדוגמה לשימוש

כדי להמחיש איך אפשר להשתמש בשירות הגישה של Merchant API MCP כדי ליצור פעולות מבוססות-AI ותהליכי עבודה אוטומטיים, הנה כמה תרחישים:

תרחיש 1: אבחון ופתרון של פסילות מוצרים

אתם רוצים להבין למה מוצר ספציפי לא מופיע בתוצאות החיפוש ב-Google.

הנחיה למשתמש:

"למה המוצר שלי עם מזהה המבצע offer123 נפסל?"

התנהגות הסוכן עם MCP:

  1. הנציג מתקשר אל list_products או אל get_product_by_name כדי לאתר את סטטוס המוצר.
  2. שרת ה-MCP מחזיר את סטטוס המוצר, כולל רשימה של issues (לדוגמה, 'פורמט מחיר שגוי' או 'חסר ערך משלוח').
  3. הסוכן ינתח את הבעיות ויסביר לכם את שורש הבעיה, ויציע לכם איך לפתור אותה (למשל, לעדכן את פרטי המחיר).

תרחיש 2: בדיקת ההסכמה לשיפורים אוטומטיים

אתם רוצים לוודא שהשיפור האוטומטי של הערכת זמני משלוח פעיל.

הנחיה למשתמש:

האם הפעלתי את השיפור האוטומטי של הערכת זמני משלוח?

התנהגות הסוכן עם MCP:

  1. הסוכן מתקשר אל get_automatic_improvements כדי לאחזר את ההגדרות ברמת החשבון.
  2. שרת ה-MCP מחזיר את ההגדרה שמציגה את הסטטוס של שיפורי התמונות, הפריטים והמשלוחים.
  3. הנציג יאשר שהשיפורים במשלוח פעילים, או יסביר איך להפעיל אותם אם הם מושבתים.

תרחיש 3: יצירת דוחות ביצועים ותובנות

אתם רוצים לבדוק במהירות את הביצועים האחרונים בלי לנווט בממשק המשתמש של Merchant Center.

הנחיה למשתמש:

‫"Show me my top 5 performing products by clicks last week" ‏(הצגת 5 המוצרים המובילים שלי לפי מספר הקליקים בשבוע שעבר)

התנהגות הסוכן עם MCP:

  1. הסוכן בונה שאילתת Merchant Center Query Language‏ (MCQL) שמטרתה הטבלה product_performance_view, מסדרת לפי clicks DESC ומגבילה ל-5.
  2. הסוכן מתקשר אל report_search עם השאילתה שנבנתה.
  3. שרת ה-MCP מריץ את השאילתה מול מסד הנתונים של הדוחות הפעילים ומחזיר את השורות.
  4. הסוכן מעצב את התוצאות בטבלת Markdown מסודרת בשבילכם.

תרחיש 4: יצירה ואחזור של מקורות נתונים

אתם רוצים להוסיף מקור נתונים חדש כדי להעלות עדכונים למוצרים.

הנחיה למשתמש:

‫"Create a supplemental data source named 'price-updates' for my merchant account."

התנהגות הסוכן עם MCP:

  1. הסוכן מתקשר אל create_data_source עם ההגדרות שצוינו כדי לרשום את הפיד החדש.
  2. שרת ה-MCP יוצר את מקור הנתונים ומחזיר את שם המשאב הייחודי שלו.
  3. הנציג מתקשר אל fetch_data_source כדי להפעיל את ההורדה והעיבוד של הקובץ המשויך.
  4. הסוכן מתקשר get_file_upload כדי לעקוב אחרי התקדמות ההעלאה ולאשר שהפריטים עברו עיבוד בהצלחה.

כלי MCP ותיאורים

שירות הגישה ל-MCP של Merchant API חושף את הכלים הבאים לסוכן:

כלי MCP תיאור
get_product_by_name קבלת מידע על מוצר של מוֹכר מסוים באמצעות שם המשאב המדויק של המוצר. הפונקציה מחזירה את סטטוס המוצר המפורט, שכולל את הקשר הדיווח ובעיות אפשריות ברמת המוצר.
list_products אפשר להציג רשימה של כמה מוצרים של מוכר מסוים או לחפש אותם. הפונקציה מחזירה את סטטוס המוצר המפורט, שכולל את הקשר הדיווח ובעיות פוטנציאליות ברמת המוצר עבור כמה מוצרים.
report_search אפשר להריץ שאילתות על טבלאות דיווח כדי לאחזר מדדים לבדיקת ביצועים של מוצרים, סטטוסים של מוצרים, תובנות לגבי מחירים ונתוני חשיפה בהשוואה למתחרים. פרטים נוספים זמינים במדריך הדוחות.
list_data_sources רשימה של מקורות נתונים זמינים למוֹכר מסוים.
get_data_source קבלת פרטים על מקור נתונים ספציפי.
create_data_source יוצרים מקור נתונים חדש למוֹכר מסוים.
fetch_data_source אחזור ועיבוד של הקובץ שמשויך למקור נתונים של מוֹכר מסוים.
get_file_upload לקבל את הסטטוס של העלאת הקובץ האחרונה למקור נתונים מסוים.
list_accounts רשימת החשבונות של משתמש מסוים.
list_account_issues אפשר להציג רשימה של בעיות ברמת החשבון של מוֹכר מסוים כדי לזהות בעיות שמשפיעות על כל החשבון.
list_programs רשימת תוכניות של מוכר מסוים, כולל סטטוס ההשתתפות, האזורים הפעילים ודרישות שלא מתקיימות.
list_aggregate_product_statuses רשימה של בעיות מצטברות ברמת המוצר, כדי לעקוב אחרי המצב הכללי של נתוני המוצרים.
get_automatic_improvements הגדרות לשיפורים אוטומטיים, כולל עדכוני פריטים, שיפורי תמונות ושיפורים של פרטי משלוח.