Merchant API MCP Access Service (Alpha)

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

ภาพรวม

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

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

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

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

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

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

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

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

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

การเปลี่ยนแปลงและรุ่นต่างๆ

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

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

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

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

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

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

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

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

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

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

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

หากต้องการเชื่อมต่อ IDE, ความช่วยเหลือในการเขียนโค้ด หรือ Agent กับบริการเข้าถึง MCP ของ Merchant API ให้อัปเดตการตั้งค่าไคลเอ็นต์ MCP (เช่น mcp.json หรือ settings.json)

การกำหนดค่าไคลเอ็นต์

การตั้งค่าการกำหนดค่า

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

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}"

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/list" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: list_data_sources" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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

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

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

คุณต้องการทราบสาเหตุที่สินค้าที่เฉพาะเจาะจงไม่แสดงในผลการค้นหาของ Google Search

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

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

ลักษณะการทำงานของ Agent กับ MCP:

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

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

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

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

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

ลักษณะการทำงานของ Agent กับ MCP:

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

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

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

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

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

ลักษณะการทำงานของ Agent กับ MCP:

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

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

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

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

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

ลักษณะการทำงานของ Agent กับ MCP:

1. Agent จะเรียกใช้ create_data_source ด้วยการตั้งค่าที่ระบุเพื่อลงทะเบียนฟีดใหม่
2. เซิร์ฟเวอร์ MCP จะสร้างแหล่งข้อมูลและแสดงชื่อทรัพยากรที่ไม่ซ้ำกัน
3. Agent จะเรียกใช้ fetch_data_source เพื่อทริกเกอร์การดาวน์โหลดและประมวลผลไฟล์ที่เกี่ยวข้อง
4. ตัวแทนจะเรียกใช้ get_file_upload เพื่อตรวจสอบความคืบหน้าในการอัปโหลดและยืนยันสถานะการประมวลผลที่สำเร็จของรายการ

เครื่องมือ MCP และคำอธิบาย

บริการเข้าถึง MCP ของ Merchant API จะแสดงเครื่องมือต่อไปนี้แก่ Agent ของคุณ