Merchant API MCP Access Service (Alpha)

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

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

ภาพรวม

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

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

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

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

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

• การตรวจสอบสิทธิ์: การดำเนินการเครื่องมืออยู่ภายใต้การตรวจสอบสิทธิ์ Merchant API มาตรฐานซึ่งต้องใช้ ข้อมูลเข้าสู่ระบบ OAuth 2.0 หรือบัญชีบริการ เราขอแนะนำให้ใช้ข้อมูลเข้าสู่ระบบที่มีสิทธิ์เข้าถึงที่จำกัดที่สุดเท่าที่จะเป็นไปได้
• ความปลอดภัยในการดำเนินการ: แม้ว่าจะไม่มีการจำกัดการแสดงเครื่องมือสำหรับการค้นพบที่เป็น Agent แต่การดำเนินการเครื่องมือจะจำกัดไว้ที่ข้อมูลเข้าสู่ระบบ 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)

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

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

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' ของฉันจึงไม่ได้รับอนุมัติ"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เครื่องมือ MCP	คำอธิบาย
get_product_by_name	รับข้อมูลผลิตภัณฑ์สำหรับ Merchant ที่ระบุโดยใช้ชื่อทรัพยากรผลิตภัณฑ์ที่ถูกต้อง แสดงสถานะผลิตภัณฑ์โดยละเอียดที่มีบริบทการรายงานและปัญหาที่อาจเกิดขึ้นในระดับสินค้า
list_products	แสดงหรือค้นหาผลิตภัณฑ์หลายรายการสำหรับ Merchant ที่ระบุ แสดงสถานะผลิตภัณฑ์โดยละเอียดที่มีบริบทการรายงานและปัญหาที่อาจเกิดขึ้นในระดับสินค้าสำหรับผลิตภัณฑ์หลายรายการ
report_search	ค้นหาตารางรายงานเพื่อดึงข้อมูลเมตริกประสิทธิภาพผลิตภัณฑ์ สถานะผลิตภัณฑ์ ข้อมูลเชิงลึกด้านราคา และการแสดงผลเทียบกับคู่แข่ง ดูรายละเอียดได้ในคู่มือรายงาน
list_data_sources	แสดงแหล่งข้อมูลที่มีสำหรับ Merchant ที่ระบุ
get_data_source	ดูรายละเอียดของแหล่งข้อมูลที่เฉพาะเจาะจง
create_data_source	สร้างแหล่งข้อมูลใหม่สำหรับ Merchant ที่ระบุ
fetch_data_source	ดึงข้อมูลและประมวลผลไฟล์ที่เชื่อมโยงกับแหล่งข้อมูลสำหรับ Merchant ที่ระบุ
get_file_upload	ดูสถานะการอัปโหลดไฟล์ล่าสุดสำหรับแหล่งข้อมูลที่ระบุ
list_accounts	แสดงบัญชีสำหรับผู้ใช้ที่ระบุ
list_account_issues	แสดงปัญหาระดับบัญชีสำหรับ Merchant ที่ระบุเพื่อระบุปัญหาทั่วทั้งบัญชี
list_programs	แสดงโปรแกรมสำหรับ Merchant ที่ระบุ ซึ่งรวมถึงสถานะการเข้าร่วม ภูมิภาคที่ใช้งานอยู่ และข้อกำหนดที่ไม่เป็นไปตามเงื่อนไข
list_aggregate_product_statuses	แสดงปัญหาระดับสินค้าที่รวบรวมไว้เพื่อตรวจสอบประสิทธิภาพโดยรวมของข้อมูลสินค้า
get_automatic_improvements	ดูการตั้งค่าการปรับปรุงอัตโนมัติ ซึ่งรวมถึงการอัปเดตสินค้า การปรับปรุงรูปภาพ และการปรับปรุงการจัดส่ง