Merchant API MCP Access Service (Alpha)

ใช้บริการเข้าถึง Model Context Protocol (MCP) ของ Merchant API เพื่อรับสิทธิ์เข้าถึงข้อมูลและข้อมูลเชิงลึกของ Merchant Center เพื่อสร้างประสบการณ์การใช้งานแบบ Agentic และเวิร์กโฟลว์อัตโนมัติใหม่

เวอร์ชันทดลอง: ฟีเจอร์นี้เป็นเวอร์ชันอัลฟ่าทดลองที่อาจมีการเปลี่ยนแปลง ได้ทุกเมื่อโดยไม่ต้องแจ้งให้ทราบล่วงหน้า เราไม่แนะนำให้ใช้ฟีเจอร์เหล่านี้กับระบบที่มีความละเอียดอ่อนซึ่งต้องการความน่าเชื่อถือสูง

ภาพรวม

บริการเข้าถึง MCP ของ Merchant API เป็นสะพานที่ได้มาตรฐานและปลอดภัยสำหรับ LLM, Agent และผู้ช่วยเขียนโค้ดในการสร้างและจัดระเบียบประสบการณ์การใช้งานที่เป็น Agent ใหม่ และเวิร์กโฟลว์อัตโนมัติที่อิงตามข้อมูล Merchant Center

โดยเฉพาะอย่างยิ่ง จะช่วยให้เข้าถึงข้อมูล Merchant Center และรายงานและข้อมูลเชิงลึกที่ Google สร้างขึ้นได้อย่างมีสิทธิ์เพื่อดำเนินการอ่านอย่างเดียวและเขียนแบบจำกัด เพื่อจัดการกรณีการใช้งานต่างๆ เช่น

• วินิจฉัยและแก้ไขการไม่อนุมัติผลิตภัณฑ์
• สร้างรายงานประสิทธิภาพและข้อมูลเชิงลึก
• ตรวจสอบการเลือกใช้การปรับปรุงอัตโนมัติ
• สร้างและดึงข้อมูลแหล่งข้อมูล

การควบคุมความปลอดภัยและการเข้าถึง

บริการเข้าถึง MCP ของ Merchant API ออกแบบมาโดยให้ความสำคัญกับความปลอดภัยเป็นอันดับแรก

• การตรวจสอบสิทธิ์: การดำเนินการเครื่องมือจะอยู่ภายใต้การตรวจสอบสิทธิ์ API ของผู้ขายมาตรฐาน ซึ่งต้องใช้ ข้อมูลเข้าสู่ระบบ OAuth 2.0 หรือบัญชีบริการ เราขอแนะนำให้ใช้ข้อมูลเข้าสู่ระบบ ที่มีสิทธิ์เข้าถึงแบบจำกัดมากที่สุดเท่าที่จะเป็นไปได้
• ความปลอดภัยในการดำเนินการ: แม้ว่าจะไม่มีการจำกัดระดับการเข้าถึงเครื่องมือสำหรับการค้นพบแบบเอเจนต์ แต่การดำเนินการเครื่องมือจะจำกัดไว้ที่ข้อมูลเข้าสู่ระบบ API ที่เฉพาะเจาะจงของคุณ
• การป้องกัน: เครื่องมือจะจำกัดเฉพาะการดำเนินการแบบอ่านอย่างเดียวและ เครื่องมือเขียนที่มีความเสี่ยงต่ำ (เช่น การสร้างแหล่งข้อมูล) อย่างเคร่งครัดเพื่อเป็นแนวทาง ด้านความปลอดภัย

สิ่งสำคัญที่ต้องคำนึงถึง

บริการเข้าถึง MCP ของ Merchant API เป็นเวอร์ชันอัลฟ่า ขอบเขตและความสามารถจะได้รับการขยายและอาจมีการเปลี่ยนแปลง

โปรดอ่านข้อจำกัดและแนวทางปฏิบัติแนะนำต่อไปนี้ก่อนเริ่มต้น

การเปลี่ยนแปลงและการเปิดตัว

การเปลี่ยนแปลงอาจเกิดขึ้นโดยไม่ต้องแจ้งให้ทราบล่วงหน้า และจะเผยแพร่ใน หมายเหตุประจำรุ่น

การทดสอบที่ปลอดภัย

เราขอแนะนำให้ทดลองใช้บัญชีทดสอบหรือบัญชีที่ไม่ใช่บัญชีที่ใช้งานจริงก่อนที่จะใช้เครื่องมือเหล่านี้ในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ที่ใช้งานจริง

โควต้าที่ใช้ร่วมกัน

บริการเข้าถึง MCP ของ Merchant API ใช้พูลโควต้าเดียวกันกับการเรียก Merchant API มาตรฐาน การเรียกใช้เอเจนต์อาจทำให้โควต้าหมดอย่างรวดเร็ว โดยเฉพาะอย่างยิ่งสำหรับการดึงข้อมูลแหล่งข้อมูล เราขอแนะนำอย่างยิ่งให้ใช้บัญชีทดสอบเพื่อป้องกันไม่ให้ บริการที่ใช้งานจริงหยุดชะงัก

การกรองเครื่องมือและความปลอดภัย

เราจะเพิ่มความสามารถใหม่ๆ โดยเฉพาะการดำเนินการเขียนในอนาคต เราขอแนะนำเป็นอย่างยิ่งให้กำหนดค่าไคลเอ็นต์อย่างชัดเจนเพื่อใช้ การกรองเครื่องมือในตัวแทนที่จะแสดงชุดเครื่องมือทั้งหมด

สรุปความสามารถที่มีให้ใช้งาน

คุณใช้บริการเข้าถึง MCP ของ Merchant API เพื่อดำเนินการต่อไปนี้ได้ ในลักษณะที่เป็น Agent

• ดึงบริบทสถานะและการรายงานโดยละเอียดสำหรับสินค้าที่เฉพาะเจาะจง โดยใช้ชื่อทรัพยากรที่ตรงกันทุกประการ
• แสดงและค้นหาผลิตภัณฑ์หลายรายการ
• เมตริกประสิทธิภาพคำค้นหา สถานะผลิตภัณฑ์ และข้อมูลเชิงลึกเกี่ยวกับสินค้ายอดนิยม ข้อมูลเชิงลึกด้านราคา การแสดงผลเทียบกับคู่แข่ง และข้อมูลวิเคราะห์แอฟฟิลิเอตของ YouTube Shopping
• ระบุปัญหาระดับบัญชีที่ส่งผลต่อการแสดงผลิตภัณฑ์หรือการเข้าร่วมโปรแกรม
• แสดง สร้าง ดึงข้อมูล และตรวจสอบสถานะการอัปโหลดของแหล่งข้อมูล
• แสดงเหตุผลที่รวบรวมไว้สำหรับการไม่อนุมัติผลิตภัณฑ์ในสินค้าคงคลัง
• ตรวจสอบการตั้งค่าการปรับปรุงอัตโนมัติสำหรับสินค้า รูปภาพ และ การจัดส่ง
• ตรวจสอบภูมิภาคที่ใช้งานอยู่ ข้อกำหนดที่ยังไม่เป็นไปตามข้อกำหนด และสถานะการเข้าร่วม สำหรับโปรแกรม Merchant Center ที่เฉพาะเจาะจง

เริ่มต้นใช้งาน

หากต้องการเชื่อมต่อ IDE, ผู้ช่วยการเขียนโค้ด หรือตัวแทนกับบริการเข้าถึง MCP ของ Merchant API ให้อัปเดตการตั้งค่าไคลเอ็นต์ 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 มาตรฐานไปยังปลายทาง MCP ของ Merchant API ที่โฮสต์โดยตรง

แสดงรายการเครื่องมือที่มี:

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 ที่เชื่อมโยงกับบัญชี Merchant Center

หมายเหตุ: ส่วนหัว x-goog-user-project (หรือ X-Goog-User-Project) จะระบุรหัสโปรเจ็กต์ Google Cloud สำหรับการระบุแหล่งที่มาของโควต้า คุณต้องระบุส่วนหัวนี้เมื่อใช้ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (ADC) ของผู้ใช้ ไม่จำเป็นต้องระบุเมื่อตรวจสอบสิทธิ์ด้วยคีย์ส่วนตัวของบัญชีบริการหรือรหัสไคลเอ็นต์ OAuth 2.0 มาตรฐาน

ตัวอย่างสถานการณ์การใช้งาน

หากต้องการแสดงให้เห็นวิธีใช้ประโยชน์จากบริการเข้าถึง MCP ของ Merchant API เพื่อสร้าง ประสบการณ์การใช้งานที่เป็น Agent และเวิร์กโฟลว์อัตโนมัติ ให้พิจารณาสถานการณ์ต่อไปนี้

สถานการณ์ที่ 1: วินิจฉัยและแก้ไขการไม่อนุมัติผลิตภัณฑ์

คุณต้องการทราบสาเหตุที่ผลิตภัณฑ์หนึ่งๆ ไม่แสดงในผลการค้นหาของ Google

พรอมต์ของผู้ใช้:

"เหตุใดผลิตภัณฑ์ของฉันที่มีรหัสข้อเสนอ 'offer123' จึงไม่ได้รับอนุมัติ"

ลักษณะการทำงานของตัวแทนที่มี MCP:

1. เอเจนต์เรียกใช้ list_products หรือ get_product_by_name เพื่อค้นหาสถานะผลิตภัณฑ์
2. เซิร์ฟเวอร์ MCP จะแสดงสถานะผลิตภัณฑ์ รวมถึงรายการissues (เช่น "รูปแบบราคาไม่ถูกต้อง" หรือ "ไม่มีค่าจัดส่ง")
3. โดยเอเจนต์จะวิเคราะห์ปัญหาและอธิบายสาเหตุหลักให้คุณทราบ พร้อมแนะนำวิธีแก้ไข (เช่น การอัปเดตข้อมูลราคา)

สถานการณ์ที่ 2: ตรวจสอบการเลือกใช้การปรับปรุงอัตโนมัติ

คุณต้องการยืนยันว่าการปรับปรุงการจัดส่งอัตโนมัติใช้งานอยู่หรือไม่

พรอมต์ของผู้ใช้:

"ฉันเปิดใช้การปรับปรุงการจัดส่งอัตโนมัติแล้วใช่ไหม"

ลักษณะการทำงานของตัวแทนที่มี MCP:

1. Agent จะเรียกใช้ get_automatic_improvements เพื่อดึงข้อมูล การตั้งค่าระดับบัญชี
2. เซิร์ฟเวอร์ MCP จะแสดงผลการกำหนดค่าที่แสดงสถานะของการปรับปรุงรูปภาพ สินค้า และการจัดส่ง
3. ตัวแทนจะยืนยันว่าการปรับปรุงการจัดส่งใช้งานอยู่ หรืออธิบาย วิธีเปิดใช้หากปิดอยู่

สถานการณ์ที่ 3: สร้างรายงานประสิทธิภาพและข้อมูลเชิงลึก

คุณต้องการตรวจสอบประสิทธิภาพล่าสุดอย่างรวดเร็วโดยไม่ต้องไปที่ UI ของ Merchant Center

พรอมต์ของผู้ใช้:

"แสดงผลิตภัณฑ์ 5 รายการที่มีประสิทธิภาพสูงสุดตามจำนวนคลิกของสัปดาห์ที่แล้ว"

ลักษณะการทำงานของตัวแทนที่มี MCP:

1. เอเจนต์สร้างคำค้นหา Merchant Center Query Language (MCQL) โดยกำหนดเป้าหมายตาราง product_performance_view จัดเรียงตาม clicks DESC และจำกัดไว้ที่ 5
2. Agent จะเรียกใช้ report_search ด้วยคำค้นหาที่สร้างขึ้น
3. เซิร์ฟเวอร์ MCP จะเรียกใช้การค้นหาในฐานข้อมูลการรายงานแบบเรียลไทม์ และแสดงผลแถว
4. Agent จะจัดรูปแบบผลลัพธ์เป็นตารางมาร์กดาวน์ที่ชัดเจนให้คุณ

สถานการณ์ที่ 4: สร้างและดึงข้อมูลแหล่งข้อมูล

คุณต้องการเพิ่มแหล่งข้อมูลใหม่เพื่ออัปโหลดข้อมูลอัปเดตผลิตภัณฑ์

พรอมต์ของผู้ใช้:

"สร้างแหล่งข้อมูลเสริมชื่อ "price-updates" สำหรับบัญชีผู้ขายของฉัน"

ลักษณะการทำงานของตัวแทนที่มี MCP:

1. Agent จะเรียกใช้ create_data_source ด้วยการตั้งค่าที่ระบุเพื่อ ลงทะเบียนฟีดใหม่
2. เซิร์ฟเวอร์ MCP จะสร้างแหล่งข้อมูลและแสดงชื่อทรัพยากรที่ไม่ซ้ำกัน
3. Agent จะเรียกใช้ 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	รับการตั้งค่าการปรับปรุงอัตโนมัติ ซึ่งรวมถึงการอัปเดตสินค้า การปรับปรุงรูปภาพ และการปรับปรุงการจัดส่ง