หากต้องการใช้ Merchant API อย่างมีประสิทธิภาพ คุณควรทำความเข้าใจแนวคิดเกี่ยวกับการลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์ โดยมีวัตถุประสงค์ที่แตกต่างกันในการตรวจสอบว่าการเข้าถึงข้อมูล Merchant Center มีความปลอดภัยและถูกต้อง
คำศัพท์
การลงทะเบียน การตรวจสอบสิทธิ์ และการให้สิทธิ์มีความเกี่ยวข้องกัน แต่แต่ละอย่างก็มีความหมายและวัตถุประสงค์ที่แตกต่างกัน
- การตรวจสอบสิทธิ์: ในกระบวนการนี้ บริการจะยืนยันตัวตนของผู้ใช้หรือแอปพลิเคชันที่ส่งคำขอ API Merchant API ใช้กลไกมาตรฐานของ Google เช่น OAuth 2.0 ระบบไม่รองรับการใช้คีย์ API สำหรับการตรวจสอบสิทธิ์ และจะทำให้เกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตรวจสอบสิทธิ์คำขอและตรวจสอบสิทธิ์ในฐานะบัญชีของคุณเอง
- การให้สิทธิ์: กระบวนการนี้จะกำหนดการดำเนินการที่ผู้ใช้หรือแอปพลิเคชันที่ผ่านการตรวจสอบสิทธิ์ได้รับอนุญาตให้ทำโดยใช้บัญชี Merchant Center ซึ่งจะตอบคำถามที่ว่า "คุณทำอะไรได้บ้าง" โดยอิงตามบทบาทและสิทธิ์ที่มอบให้แก่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วภายในบัญชี Merchant Center เช่น ผู้ใช้อาจได้รับอนุญาตให้อ่านข้อมูลผลิตภัณฑ์ แต่ไม่ได้รับอนุญาตให้แก้ไขการตั้งค่าบัญชี
- การลงทะเบียน: สำหรับ Merchant API ขั้นตอนนี้เป็นการตั้งค่าแบบครั้งเดียวที่ช่วยให้ Google ส่งประกาศเกี่ยวกับการให้บริการที่สำคัญสำหรับบัญชีผู้ขายที่คุณจัดการได้ การลงทะเบียนจะเพิ่มอีเมลนักพัฒนาแอปของคุณลงในบัญชี Merchant Center หลักและลิงก์กับรหัสโปรเจ็กต์ Google Cloud ที่คุณใช้สำหรับการตรวจสอบสิทธิ์ การลิงก์นี้ช่วยให้แอปพลิเคชันของคุณได้รับประกาศเกี่ยวกับการให้บริการสำหรับบัญชีผู้ขายทั้งหมดที่คุณจัดการ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างโปรเจ็กต์ Google Cloud
การลงทะเบียน
ขั้นตอนการลงทะเบียนมีความสำคัญอย่างยิ่งต่อการเปิดใช้แอปพลิเคชันเพื่อใช้ Merchant API สิ่งที่จำเป็นต้องทราบมีดังนี้
ข้อกำหนดเบื้องต้น
การลงทะเบียนเพื่อใช้ Merchant API ต้องมีสิ่งต่อไปนี้
- บัญชี Merchant Center: คุณต้องมีบัญชี Merchant Center อยู่แล้ว
- สิทธิ์เข้าถึงระดับผู้ดูแลระบบ: บัญชีผู้ใช้ Google ที่คุณใช้เพื่อเริ่มการเรียกใช้การลงทะเบียนต้องมีสิทธิ์ของผู้ดูแลระบบในบัญชี Merchant Center ที่คุณกำลังลงทะเบียน
- โปรเจ็กต์ Google Cloud: แอปพลิเคชันของคุณต้องเชื่อมโยงกับโปรเจ็กต์ Google Cloud โปรเจ็กต์นี้จะให้ข้อมูลเข้าสู่ระบบที่จำเป็น (เช่น รหัสไคลเอ็นต์ OAuth 2.0) เพื่อให้แอปพลิเคชันของคุณตรวจสอบสิทธิ์
สาเหตุที่คุณลงทะเบียนโปรเจ็กต์ Google Cloud ที่แชร์ไม่ได้
เครื่องมืออย่าง Google OAuth Playground และโปรแกรมสำรวจ API จะใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่ Google เป็นเจ้าของและแชร์ไว้ คุณไม่สามารถลงทะเบียนกับโปรเจ็กต์ที่แชร์ได้เนื่องจากสาเหตุต่อไปนี้
- โดยมีไว้สำหรับการทดสอบและการสำรวจ ไม่ใช่สำหรับข้อมูลประจำตัวของแอปพลิเคชันเวอร์ชันที่ใช้งานจริง
- การลงทะเบียนอีเมลดังกล่าวจะหมายถึงการลิงก์ระหว่างเครื่องมือที่แชร์กับข้อมูล Merchant Center ที่เฉพาะเจาะจงของคุณ และอาจส่งผลให้เกิดการสื่อสารที่ไม่พึงประสงค์
แอปพลิเคชันของคุณต้องมีโปรเจ็กต์ Google Cloud เฉพาะของตัวเอง เพื่อให้การสื่อสารเกี่ยวกับ Merchant API ที่ Google ส่งถึงคุณยังคงเกี่ยวข้องกับการใช้งานจริงของคุณ
อย่างไรก็ตาม คุณสามารถใช้เว็บแอป OAuth Playground และโปรแกรมสำรวจ API เพื่อใช้ Merchant API สำหรับการทดสอบและ Use Case ที่ไม่ใช่การใช้งานจริงได้
ค้นหารหัสโปรเจ็กต์ Google Cloud
คุณดูรหัสโปรเจ็กต์และหมายเลขโปรเจ็กต์ได้ในคอนโซล Google Cloud โปรดดูรายละเอียดที่หัวข้อค้นหาชื่อ หมายเลข และรหัสโปรเจ็กต์
โทรเพื่อลงทะเบียน
ลงทะเบียนโดยใช้เมธอด registerGcp ภายใน API ย่อย Accounts การเรียกนี้จะเชื่อมโยงหมายเลขโปรเจ็กต์ Google Cloud กับบัญชี Merchant Center
ในระหว่างกระบวนการ คุณควรระบุอีเมลที่เชื่อมโยงกับผู้ใช้แต่ละรายที่คุณใช้เรียก API อีเมลนี้ต้องเป็นของผู้ใช้ที่มีสิทธิ์เข้าถึงระดับผู้ดูแลระบบในบัญชี Merchant Center
เกี่ยวกับช่องอีเมล
การสื่อสารที่มีประสิทธิภาพคือกุญแจสำคัญ Google จะส่งข้อมูลอัปเดตที่สำคัญ ประกาศการให้บริการที่คุณจำเป็นต้องได้รับ (MSA) แบบสำรวจนักพัฒนาแอป และโอกาสอื่นๆ ที่เกี่ยวข้องกับ Merchant API การจัดการรายชื่อติดต่อที่เหมาะสมจะช่วยให้มั่นใจได้ว่าข้อมูลเหล่านี้จะเข้าถึงผู้ที่เหมาะสม
- วัตถุประสงค์: Google ใช้อีเมลนี้เป็นผู้ติดต่อหลักสำหรับการสื่อสารที่เกี่ยวข้องกับ API
- อีเมลของใคร: ควรเป็นอีเมลของนักพัฒนาซอฟต์แวร์แต่ละรายหรือผู้ติดต่อด้านเทคนิคหลักที่รับผิดชอบการผสานรวม API
- แนวทางปฏิบัติแนะนำ
- สิ่งที่ควรทำ: ใช้อีเมลของบริษัทของบุคคลธรรมดา
- อย่าใช้อีเมลแทนของกลุ่มทั่วไปหรืออีเมลบัญชีบริการ เราตั้งใจให้การสื่อสารมีไว้สำหรับผู้รับที่เป็นมนุษย์
แหล่งข้อมูล users สำหรับการจัดการรายชื่อติดต่อ
แม้ว่าอีเมลในการเรียกใช้การลงทะเบียนจะตั้งค่าผู้ติดต่อเริ่มต้น แต่วิธีที่มีประสิทธิภาพมากกว่าในการจัดการผู้ติดต่อและสิทธิ์คือการใช้ทรัพยากร accounts.users ของ Merchant API หรือการตั้งค่าการจัดการผู้ใช้ใน UI ของ Merchant Center ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Merchant Center ได้ที่หัวข้อจัดการผู้ใช้ในบัญชี
ใช้ประโยชน์จากฟีเจอร์เหล่านี้ได้ดังนี้
- เพิ่มนักพัฒนาแอปทั้งหมด: เพิ่มนักพัฒนาแอปที่ทำงานเกี่ยวกับการผสานรวม API เป็นผู้ใช้บัญชี Merchant Center
- มอบหมายบทบาท
API_DEVELOPER: นอกจากบทบาทมาตรฐาน (ผู้ดูแลระบบ, มาตรฐาน) คุณยังมอบหมายบทบาทAPI_DEVELOPERให้กับผู้ใช้ได้ด้วย โดยเฉพาะอย่างยิ่ง ให้มอบหมายบทบาทนี้ให้กับผู้ใช้ที่ควรได้รับการสื่อสารที่เกี่ยวข้องกับ API คุณสามารถใช้บทบาทนี้ร่วมกับบทบาทอื่นๆ ได้ - สิทธิประโยชน์
- การแยกที่ชัดเจน: แยกการจัดการรายชื่อติดต่อ API ออกจากการลงทะเบียนแบบครั้งเดียว
- ความยืดหยุ่น: อัปเดตรายชื่อติดต่อเมื่อสมาชิกในทีมมีการเปลี่ยนแปลง
- การสื่อสารที่ตรงเป้าหมาย: ช่วยให้มั่นใจว่าข่าวสารเกี่ยวกับ API จะส่งถึงผู้ที่เกี่ยวข้อง
แม้ว่าคุณจะระบุอีเมลในระหว่างการลงทะเบียนแล้ว แต่เราขอแนะนำอย่างยิ่งให้จัดการผู้ติดต่อ API โดยเพิ่มผู้ใช้ที่มีบทบาท API_DEVELOPER
ข้อมูลอ้างอิง
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้