Merchant API MCP Access Service (אלפא)

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

סקירה כללית

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

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

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

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

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

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

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

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

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

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

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

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

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

מכסה משותפת

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

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

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

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

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

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

תחילת העבודה

כדי לחבר את סביבת הפיתוח המשולבת (IDE), העוזר האישי לתכנות או הסוכן שלכם ל-Merchant API MCP Access Service, צריך לעדכן את הגדרות לקוח ה-MCP (לדוגמה, mcp.json או settings.json).

הגדרת לקוח

הגדרות אישיות:

Antigravity

מתחברים ישירות לנקודת הקצה המרוחקת של ה-MCP שמתארחת באמצעות אסימון גישה מסוג OAuth 2.0 (עם היקף https://www.googleapis.com/auth/content). פועלים לפי ההוראות במסמכי Antigravity.

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

Claude CLI

מוסיפים את נקודת הקצה המרוחקת של ה-MCP שמתארחת ישירות ב-Claude CLI באמצעות הפקודה claude mcp add:

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

פועלים לפי ההוראות במסמכי התיעוד של Claude MCP.

cURL

שולחים בקשות רגילות בפורמט JSON-RPC 2.0 ישירות לנקודת הקצה של Merchant API MCP שמתארחת.

רשימת הכלים הזמינים:

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

ביצוע קריאה לכלי (לדוגמה, list_data_sources):

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ACCOUNT_ID: מספר חשבון Merchant Center
  • ‫ACCESS_TOKEN: אסימון ההרשאה לביצוע הקריאה ל-API
  • ‫GOOGLE_CLOUD_PROJECT_ID: המזהה של פרויקט Google Cloud שמשויך לחשבון Merchant Center

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

כדי להמחיש איך אפשר להשתמש בשירות הגישה של 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: יצירה ואחזור של מקורות נתונים

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

פרומפט של משתמש:

"צור מקור נתונים משלים בשם price-updates לחשבון המוכר שלי".

התנהגות הסוכן עם 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 הגדרות לשיפורים אוטומטיים, כולל עדכוני פריטים, שיפורי תמונות ושיפורים של פרטי משלוח.