คำแนะนำในการย้ายข้อมูลรหัสไคลเอ็นต์

ภาพรวม

ทำตามขั้นตอนต่อไปนี้เพื่อเริ่มต้น:

1. ตรวจสอบการใช้งานรหัสไคลเอ็นต์ปัจจุบัน
2. เตรียมคีย์ API
3. ตรวจสอบการตั้งค่าโควต้า
4. อัปเดตโค้ด
5. ตรวจสอบการเข้าชมรหัสไคลเอ็นต์
6. หยุดรหัสไคลเอ็นต์ชั่วคราว
7. การเปิดใช้งานรหัสไคลเอ็นต์อีกครั้งชั่วคราวแบบบริการตนเอง

ตรวจสอบการใช้งานรหัสไคลเอ็นต์ปัจจุบัน

ก่อนเริ่มกระบวนการย้ายข้อมูล ให้ทำรายการต่อไปนี้

• บริการ Maps Platform ที่คุณใช้กับรหัสไคลเอ็นต์
• แอปพลิเคชัน เว็บไซต์ หรือระบบที่คุณใช้ Client-ID

Google ได้ส่งอีเมลแจ้งเตือนไปยังลูกค้าที่ได้รับผลกระทบเกี่ยวกับการเลิกใช้งานรหัสไคลเอ็นต์ในเดือนพฤษภาคม 2025 คุณดูข้อมูลนี้ได้ในอีเมลแจ้งเตือนด้วย

ใน Cloud Console คุณสามารถตรวจสอบสถานะล่าสุดของการใช้งาน Client ID ได้ ในหน้าเมตริกของ Google Maps

สำหรับรายการบริการของ Maps Platform

1. เปิดหน้า เมตริก ใน Cloud Console
2. กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
   • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
3. ตั้งค่าตัวกรองต่อไปนี้
   • จัดกลุ่มตาม: API

สำหรับคำแนะนำเกี่ยวกับแอปพลิเคชัน เว็บไซต์ หรือระบบ

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

1. เปิดหน้า เมตริก ใน Cloud Console
2. เลือกบริการ Maps Platform จากเมนูแบบเลื่อนลง
3. กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
   • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
4. ตั้งค่าตัวกรองต่อไปนี้
   • จัดกลุ่มตาม: แพลตฟอร์มหรือโดเมน
5. ทำซ้ำตั้งแต่ขั้นตอนที่ 2 สำหรับบริการ Maps Platform แต่ละรายการที่คุณต้องการ ตรวจสอบการเข้าชม

เตรียมคีย์ API

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

1. ค้นหาโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ลิงก์กับรหัสไคลเอ็นต์ของคุณ
   • คำถามที่พบบ่อยเกี่ยวกับการย้ายข้อมูลพอร์ทัล
2. ตรวจสอบว่าโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ลิงก์กับบัญชีสำหรับการเรียกเก็บเงินที่เปิดอยู่
3. สร้างคีย์ API ใหม่ สำหรับการย้ายข้อมูลรหัสไคลเอ็นต์
   • คุณสามารถใช้คีย์ API ที่มีอยู่ซ้ำในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้
   • คุณสามารถใช้คีย์ API หลายรายการจากโปรเจ็กต์ที่อยู่ในระบบคลาวด์เดียวกันได้ เช่น เพื่อแยกการรับส่งข้อมูลสำหรับบริการ Maps Platform แต่ละรายการ หรือเพื่อแยกการรับส่งข้อมูลจากแพลตฟอร์มต่างๆ (เบราว์เซอร์ แอปบนอุปกรณ์เคลื่อนที่ และอื่นๆ) โปรดดูแนวทางปฏิบัติแนะนำเกี่ยวกับการจัดการคีย์ API ในคู่มือด้านความปลอดภัย

รักษาความปลอดภัยให้คีย์ API

โปรดรักษาความปลอดภัยของคีย์ API เพื่อปกป้องคีย์จากการเข้าถึงที่ไม่ได้รับอนุญาต

• ตั้งค่าการจำกัดแอปพลิเคชันสำหรับคีย์ API (เช่น เว็บไซต์, ที่อยู่ IP, แอป Android หรือแอป iOS)
• ตั้งค่าข้อจำกัด API สำหรับคีย์ API

ดูรายละเอียดเพิ่มเติมได้ที่คำแนะนำด้านความปลอดภัยของ Google Maps Platform

สำหรับ Maps JavaScript API, Maps Static API และ Street View Static API คุณสามารถ ย้ายข้อมูลผู้แนะนำที่เชื่อถือได้ในรหัสไคลเอ็นต์ไปยังข้อจำกัดของคีย์ API คุณดูรายชื่อผู้้างอิงที่เชื่อถือได้ใน Cloud Console ได้

ตรวจสอบการตั้งค่าโควต้า

ตรวจสอบว่าคุณมีการตั้งค่าโควต้าที่คาดไว้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ คุณต้องดำเนินการนี้ก็ต่อเมื่อเรียกใช้บริการฝั่งไคลเอ็นต์ของ Maps JavaScript API จากรหัสไคลเอ็นต์เท่านั้น คุณตรวจสอบและปรับการตั้งค่าโควต้าได้ใน หน้าโควต้าของ Google Maps

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายงานโควต้า

การเพิ่มโควต้าสำหรับบริการฝั่งไคลเอ็นต์ของ Maps JavaScript API

หากใช้บริการต่อไปนี้ใน Maps JavaScript API คุณจะเห็นการใช้งานโควต้าเพิ่มขึ้นหลังจากย้ายข้อมูลคีย์ API

ตรวจสอบการกำหนดค่าโควต้าปัจจุบัน การใช้งานปัจจุบัน และ ปรับขีดจำกัดโควต้าตามนั้น

1. ตรวจสอบว่าคุณใช้บริการฝั่งไคลเอ็นต์ของ Maps JavaScript API กับรหัสไคลเอ็นต์หรือไม่
   • เปิดหน้าเมตริกใน Cloud Console
   • กรองการใช้งานด้วยการตั้งค่าต่อไปนี้
     • จัดกลุ่มตาม: เมธอด API
     • ข้อมูลเข้าสู่ระบบ: เลือกเฉพาะ "project_number:<ตัวระบุที่เป็นตัวเลข>"
   • จากนั้นคุณจะเห็นรายการชื่อเมธอดพร้อมการเข้าชมในแผนภูมิ "การเข้าชม ตามเมธอด API"

• หากไม่ได้ใช้เมธอด API เหล่านั้น คุณก็ไม่ต้องกังวลเกี่ยวกับการตั้งค่าโควต้า เนื่องจากการเข้าชมรหัสไคลเอ็นต์ใช้โควต้าโปรเจ็กต์อยู่แล้ว
• ประมาณการใช้งานโควต้ารหัสไคลเอ็นต์
  • สำหรับแต่ละบริการ ให้ตรวจสอบทั้งความละเอียดต่อวินาทีและความละเอียดต่อวัน
  • กราฟต่อวินาที: คูณการเข้าชมสูงสุดด้วย 60 เพื่อให้ได้โควต้าต่อนาทีเพิ่มเติม
  • กราฟต่อวัน: ปริมาณการเข้าชมสูงสุดควรเป็นโควต้าเพิ่มเติมต่อวันที่จำเป็น
• ปรับโควต้าในบริการ Maps Platform ที่เกี่ยวข้อง
  • ปรับโควต้าในบริการที่เกี่ยวข้องตามชื่อเมธอดที่คุณพบในขั้นตอนที่ 1

อัปเดตโค้ด

แทนที่พารามิเตอร์ไคลเอ็นต์ด้วยพารามิเตอร์คีย์

อัปเดตข้อมูลเข้าสู่ระบบเพื่อตรวจสอบสิทธิ์จาก URL&client={value} เป็น URL&key={value} ในการเรียก GMP API ขาออก หากแอปใช้ HTTP เพื่อเข้าถึงบริการ GMP ให้อัปเดตแอปให้ใช้ HTTPS

อัปเดตพารามิเตอร์ช่องสำหรับการรายงาน

คุณสามารถติดตามการใช้งานต่อช่องทางได้โดยระบุพารามิเตอร์ช่องทางในคำขอ API คีย์ API รองรับเฉพาะค่าตัวเลขสำหรับพารามิเตอร์แชแนล หากคุณใช้ Client ID ที่มีค่าที่ไม่ใช่ตัวเลขสําหรับพารามิเตอร์ channel ให้อัปเดตเป็นค่าตัวเลขที่รองรับ

ดูข้อมูลเพิ่มเติมได้ที่การรายงานของ Google Maps Platform

นำพารามิเตอร์ลายเซ็นสำหรับเว็บเซอร์วิสออก

สำหรับ Web Service API ต่อไปนี้ คุณไม่จำเป็นต้องใช้พารามิเตอร์ลายเซ็นเมื่อเข้าถึงด้วยคีย์ API เพียงนำพารามิเตอร์ลายเซ็นออกจากคำขอ API

• Directions API (เดิม)
• Distance Matrix API (เดิม)
• Geocoding API
• Elevation API
• Time Zone API

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมแพ็กเกจ Premium

Signing Secret สำหรับ Imagery API

Maps Static API และ Street View Static API ยังคงต้องใช้พารามิเตอร์ลายเซ็น โดยจะยอมรับคำขอจำนวนเล็กน้อยที่ไม่มีลายเซ็นเพื่อวัตถุประสงค์ในการทดสอบ แต่จะเริ่มล้มเหลวเมื่อถึงเกณฑ์ในเวอร์ชันที่ใช้งานจริง แทนที่รหัสลับการลงนามจากรหัสลับสำหรับรหัสไคลเอ็นต์เป็นรหัสลับสำหรับคีย์ API คุณสามารถใช้อัลกอริทึมการลงนามเดียวกันได้ แต่ต้องใช้ ความลับในการลงนามอื่น ดูข้อมูลเพิ่มเติมได้ที่ใช้ลายเซ็นดิจิทัล

ตรวจสอบการเข้าชมรหัสไคลเอ็นต์

หลังจากทำให้ใช้งานได้แล้ว ให้ยืนยันว่าการเข้าชมย้ายข้อมูลสำเร็จแล้วโดยใช้แดชบอร์ด Cloud Console คุณจะเริ่มเห็นการเข้าชม Client ID ลดลง ซึ่งจะแสดงในรูปแบบ "project_number:123456" ในแดชบอร์ดเมื่อจัดกลุ่มตามข้อมูลเข้าสู่ระบบ

หยุดรหัสไคลเอ็นต์ชั่วคราว

เราขอแนะนำอย่างยิ่งให้นักพัฒนาแอปหยุดรหัสไคลเอ็นต์ไว้ชั่วคราวหลังจากการย้ายข้อมูล เพื่อปกป้องข้อมูลเข้าสู่ระบบจากการเข้าชมที่ไม่พึงประสงค์ และเพื่อยืนยันว่าการใช้งานที่เหลือใน Client ID ไม่ใช่เรื่องสำคัญ (เช่น การทดสอบ แคช บ็อต ฯลฯ) และสามารถแสดงข้อผิดพลาดได้โดยไม่ส่งผลกระทบต่อธุรกิจ คุณสามารถหยุดรหัสไคลเอ็นต์ชั่วคราวใน Cloud Console ได้ ดูรายละเอียดเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์ของแพ็กเกจ Premium

การเปิดใช้งานรหัสไคลเอ็นต์อีกครั้งชั่วคราวแบบบริการตนเอง

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

หากต้องการคืนค่าสิทธิ์เข้าถึงอย่างเร่งด่วน คุณสามารถเปิดใช้งานอีกครั้งแบบบริการตนเองผ่าน คอนโซล Google Cloud ได้โดยทำดังนี้

• ไปที่หน้าข้อมูลเข้าสู่ระบบของ Google Maps Platform
• ค้นหาโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่เฉพาะเจาะจงซึ่งลิงก์กับรหัสไคลเอ็นต์
• คลิกไอคอนกลับมาทำงานอีกครั้งที่ด้านขวาสุดของรายการเพื่อกู้คืนบริการ

หากคุณไม่สามารถย้ายข้อมูลไปยังคีย์ API ได้อย่างรวดเร็วและต้องการได้รับการยกเว้นชั่วคราว ไม่ให้เกิดการหยุดชะงักเพิ่มเติม โปรดติดต่อทีมสนับสนุนของ Google Maps Platform พร้อมรายละเอียดต่อไปนี้

• รหัสไคลเอ็นต์
• Use Case ที่เฉพาะเจาะจง
• วันที่เป้าหมายในการย้ายข้อมูล
• การประเมินผลกระทบทางธุรกิจ

รายงานการใช้งานรหัสไคลเอ็นต์ - จากรายงานการเรียกเก็บเงิน

การตรวจสอบรายงานการเรียกเก็บเงินแทนเมตริกโปรเจ็กต์อาจเป็นประโยชน์สำหรับผู้ใช้ที่ไม่มีสิทธิ์เข้าถึงเมตริกโปรเจ็กต์ เช่น ผู้ดูแลระบบการเรียกเก็บเงิน (โดยเฉพาะพาร์ทเนอร์แพลตฟอร์ม Maps) แม้ว่ารายงานการเรียกเก็บเงินจะมีเวลาในการตอบสนอง 1-2 วัน แต่ก็มีประโยชน์ในการแสดงข้อมูลเชิงลึกเกี่ยวกับการใช้งานและค่าใช้จ่ายมากกว่า 30 วัน

คุณสามารถตรวจสอบการใช้งานรหัสไคลเอ็นต์ผ่านคอนโซล Google Cloud ได้โดยทำตามขั้นตอนต่อไปนี้

1. ไปที่หน้าการเรียกเก็บเงิน > รายงานในคอนโซล Google Cloud
2. (ไม่บังคับ เกี่ยวข้องกับพาร์ทเนอร์เท่านั้น) ใช้ตัวกรองเพื่อเลือกบัญชีสำหรับการเรียกเก็บเงินย่อยที่ต้องการ
3. จัดกลุ่มข้อมูลการรายงานตามคีย์ป้ายกำกับ goog-maps-api-key-suffix ป้ายกำกับนี้จะแสดงอักขระต่อท้ายของคีย์ API
4. ระบุการเข้าชมรหัสไคลเอ็นต์โดยมองหารายการที่ไม่มีป้ายกำกับ goog-maps-api-key-suffix หรือป้ายกำกับว่างเปล่า เนื่องจากป้ายกำกับนี้ไม่ได้สร้างขึ้นสำหรับคำขอรหัสไคลเอ็นต์
5. ไม่สนใจ SKU ที่ไม่ได้มีไว้เพื่อเชื่อมโยงกับคำขอ API เช่น SKU การสมัครใช้บริการ

การแก้ปัญหา

เราจะดูได้อย่างไรว่าคำขอของเราล้มเหลวหรือไม่

คุณตรวจสอบสถิติข้อผิดพลาดได้ในกราฟโค้ดตอบกลับ

ข้อผิดพลาด ApiNotActivatedMapError หรือ REQUEST_DENIED รายการ

คุณจะเห็นข้อผิดพลาด ApiNotActivatedMapError หรือ REQUEST_DENIED หากไม่ได้เปิดใช้บริการในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ทำตามวิธีการเพื่อเปิดใช้บริการ

ข้อผิดพลาด RefererNotAllowedMapError รายการ

คุณจะเห็นข้อผิดพลาด RefererNotAllowedMapError หากไม่ได้เพิ่มโดเมนแหล่งที่มาลงในคีย์ API ดูส่วน "รักษาคีย์ API ให้ปลอดภัย" แล้วเพิ่ม โดเมนลงในคีย์ API

ข้อผิดพลาด OverQuotaMapError หรือ OVER_QUERY_LIMIT

คุณจะเห็น OverQuotaMapError หรือ OVER_QUERY_LIMIT หากโควต้าที่คุณกำหนดค่าไว้ไม่เพียงพอต่อการรองรับการเข้าชม ดูส่วน "ตรวจสอบการตั้งค่าโควต้า" แล้วปรับโควต้าตามนั้น

ข้อผิดพลาด "คำขอไปยัง API นี้ต้องผ่าน SSL"

หากได้รับข้อความแสดงข้อผิดพลาดต่อไปนี้ ให้อัปเดตคำขอ API จาก "http://" เป็น "https://"

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}