Merchant API MCP Access Service (Alpha)

ใช้บริการเข้าถึง MCP ของ Merchant API เพื่อรับสิทธิ์เข้าถึงข้อมูลและข้อมูลเชิงลึกของ 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 สำหรับ Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code หรือเฟรมเวิร์ก Agent ที่กำหนดเอง

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

ดูวิธีการสร้างและดาวน์โหลดบัญชีบริการโดยละเอียดได้ใน คู่มือบัญชีบริการ

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

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

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

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

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

ตัวอย่างสถานการณ์ต่อไปนี้จะแสดงให้เห็นว่าคุณใช้ประโยชน์จากบริการเข้าถึง 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