Merchant API MCP Access Service (Alpha)

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

ภาพรวม

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

สรุปความสามารถที่มี

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

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

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

หากต้องการเชื่อมต่อ IDE, ผู้ช่วยการเขียนโค้ด หรือเอเจนต์กับบริการเข้าถึง MCP ของ Merchant API ให้อัปเดตการตั้งค่าไคลเอ็นต์ MCP เช่น อัปเดตmcp.json ไฟล์สำหรับ Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code หรือเฟรมเวิร์กเอเจนต์ที่กำหนดเอง

การตั้งค่าบริการเข้าถึง MCP ของ Local 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 เพื่อสร้าง ประสบการณ์การใช้งานแบบเอเจนต์และเวิร์กโฟลว์อัตโนมัติ ให้พิจารณาสถานการณ์ต่อไปนี้

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

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

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