เราขอแนะนำให้ใช้ ไลบรารีของไคลเอ็นต์ Google API เพื่อตั้งค่า Content API for Shopping ได้ คู่มือนี้ใช้ไคลเอ็นต์ Python Content API ห้องสมุดเป็นตัวอย่าง แต่ก็มีให้บริการสำหรับโปรแกรมยอดนิยมจำนวนมาก และลดความซับซ้อนของงาน API ทั่วไป เช่น การตรวจสอบสิทธิ์ การส่งคำขอ และแยกวิเคราะห์คำตอบ สำหรับความช่วยเหลือในการตั้งค่าไลบรารีของไคลเอ็นต์สำหรับ ภาษาอื่นๆ โปรดดู README.md สำหรับภาษาภายใน googleads/googleads-shopping-samples ที่เก็บใน GitHub
หากต้องการตั้งค่าไลบรารีของไคลเอ็นต์ Google API สําหรับ Python ให้ทําตามขั้นตอนต่อไปนี้
สร้างไดเรกทอรีสำหรับการกำหนดค่าและการตรวจสอบสิทธิ์ไลบรารีของไคลเอ็นต์ ภายในไดเรกทอรีหน้าแรก ให้สร้างไดเรกทอรีต่อไปนี้
~/shopping-samples/content/
หากต้องการดาวน์โหลดข้อมูลเข้าสู่ระบบของบัญชีบริการ ให้ทำตามขั้นตอนต่อไปนี้
- ไปที่ไลบรารี Google API
- เลือกโปรเจ็กต์ในเมนูที่ด้านบนของหน้า หากคุณยังไม่มีบัญชี แต่ให้สร้างโปรเจ็กต์โดยคลิกโปรเจ็กต์ใหม่
- หากยังไม่ได้เปิดใช้ Content API for Shopping สำหรับฟีเจอร์นี้ แล้วค้นหาโปรเจ็กต์นั้นในรายการ Google APIs แล้วเปิดใช้
- ในแถบด้านข้างทางซ้าย ให้เลือกข้อมูลเข้าสู่ระบบ คุณอาจต้องคลิก ลูกศรชี้ซ้ายที่ด้านซ้ายบนเพื่อดูข้อมูลนี้
- หากต้องการตั้งค่าบัญชีบริการ ให้เลือกสร้างข้อมูลเข้าสู่ระบบ จากนั้นเลือก บัญชีบริการ
- ตั้งชื่อบัญชีบริการใหม่ ชื่อนี้สามารถใช้เป็นชื่อผู้ใช้เริ่มต้นสำหรับ รหัสบัญชีบริการ บันทึกรหัสบัญชีบริการรวมถึงส่วน หลัง '@' สำหรับใช้ในภายหลัง คลิกสร้าง จากนั้นทำตามขั้นตอน ขั้นตอนที่ไม่บังคับในการให้สิทธิ์เข้าถึงโครงการและผู้ใช้และคลิก เสร็จสิ้น
- ระบบจะนำคุณไปยังหน้าบัญชีบริการซึ่งบริการใหม่ของคุณ สามารถเข้าถึงได้
หากต้องการรับคีย์ส่วนตัว JSON ให้คลิกบัญชีบริการ แล้วคลิกคีย์ คลิกเพิ่มคีย์ > สร้างคีย์ใหม่ แล้วเลือก JSON เป็นแอตทริบิวต์ ประเภทคีย์ คลิกสร้างเพื่อดาวน์โหลดคีย์ส่วนตัวลงในคอมพิวเตอร์ คีย์ใหม่จะดาวน์โหลดโดยอัตโนมัติ
เปลี่ยนชื่อไฟล์ข้อมูลเข้าสู่ระบบที่ดาวน์โหลดมาเป็น service-account.json
ย้ายไฟล์ service-account.json ไปยัง home directory/shopping-samples/content/.
ใน home directory/shopping-ตัวอย่าง/content/ ให้สร้าง ไฟล์ merchant-info.json ว่างเปล่า
เพิ่มข้อความต่อไปนี้ใน merchant-info.json
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }
เพิ่มบัญชีบริการใหม่เป็นผู้ใช้ในบัญชี Merchant Center หากคุณ เป็นนักพัฒนาซอฟต์แวร์บุคคลที่สาม คุณจะต้องให้ลูกค้าทำขั้นตอนนี้ สำหรับคุณ
- ไปที่บัญชี Merchant Center
- ในการตั้งค่าบัญชี Merchant Center ให้เลือกผู้คนและ การเข้าถึง
คลิก + เพิ่มบุคคล และใช้รหัสบัญชีบริการเป็นอีเมล สำหรับผู้ใช้ใหม่
การใช้บริการ
Accounts
ต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบ ดังนั้นโปรดเลือก ผู้ดูแลระบบคลิกเพิ่มผู้ใช้เพื่อบันทึกค่ากำหนด แล้วกลับไปยังรายการ ผู้ใช้ รหัสบัญชีบริการจะแสดงพร้อมกับบทบาทของผู้ใช้ที่เลือก
ทำขั้นตอนข้างต้นซ้ำกับบัญชีบริการอื่นๆ ทั้งหมดที่ต้องการเพิ่ม
โคลน (หรือดาวน์โหลดและคลายการบีบอัด) googleads/googleads-shopping-samples ที่เก็บ GitHub ไปยังตำแหน่งใดก็ได้ในคอมพิวเตอร์ โดยไม่จำเป็นต้องอยู่ใน ไดเรกทอรีหน้าแรกหรือใน ~/shopping-samples/content/
หากคุณดาวน์โหลดและคลายการบีบอัดที่เก็บ ให้เปลี่ยนชื่อที่เก็บแทนที่จะโคลน ไดเรกทอรีที่คลายการบีบอัดไปยัง googleads-shopping-samples
หากต้องการติดตั้งทรัพยากร Dependency ตัวอย่างที่จำเป็นในหน้าต่างเทอร์มินัล ไปที่ googleads-shopping-samples/python/ และเรียกใช้
pip install -r requirements.txt
ตอนนี้คุณมีไลบรารีของไคลเอ็นต์ Google API สำหรับ Python ที่กำหนดค่าไว้และพร้อมใช้งานกับ Content API แล้ว ในส่วนถัดไป คุณจะต้องสร้างและส่งคำขอแทรกผลิตภัณฑ์ใหม่