ตั้งค่า Time Zone API

เอกสารนี้อธิบายขั้นตอนที่จำเป็นในการเริ่มใช้ Time Zone API

ข้อกำหนดเบื้องต้น

ขั้นตอนนี้จะแนะนำวิธีตั้งค่าบัญชี Google Cloud และโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน นอกจากนี้ คุณควรทำความคุ้นเคยกับวิธีเรียกเก็บเงินสำหรับการใช้ Time Zone API ด้วย

  1. ตรวจสอบการเรียกเก็บเงินและค่าใช้จ่ายสำหรับการใช้งานที่การใช้งานและการเรียกเก็บเงินของ Time Zone API

  2. ตรวจสอบว่าคุณมีบัญชี Google Cloud

    ลงชื่อเข้าใช้คอนโซล Google Cloud

  3. ยืนยันว่าคุณมีโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน

    ไปที่หน้าการเรียกเก็บเงิน
    1. เลือกโปรเจ็กต์เพื่อเปิดหน้าการเรียกเก็บเงิน

    2. ในหน้าการเรียกเก็บเงิน ให้ทำดังนี้

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

เปิดใช้ API

ก่อนที่จะใช้ Time Zone API ได้ คุณต้องใช้คอนโซล Google Cloud หรือคำสั่ง gcloud เพื่อเปิดใช้ในโปรเจ็กต์ Google Cloud

วิธีเปิดใช้ API

คอนโซล

  1. เปิดหน้าผลิตภัณฑ์ในคอนโซล Google Cloud โดยทำดังนี้

    เปิดใช้ Time Zone API

  2. คลิกปุ่มเปิดใช้

gcloud

gcloud services enable \
    --project "PROJECT" \
    "timezone-backend.googleapis.com"

อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

รับคีย์ API เพื่อใช้กับ Time Zone API

ผลิตภัณฑ์ Google Maps Platform ได้รับการปกป้องจากการใช้งานที่ไม่ได้รับอนุญาตโดยกำหนดให้การเรียก API ต้องมีคีย์ API

คีย์ API คือสตริงตัวอักษรและตัวเลขที่ไม่ซ้ำกันซึ่งเชื่อมโยงบัญชีสำหรับการเรียกเก็บเงินใน Cloud และโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud กับคำขอที่แอปพลิเคชันส่งไปยัง Google Maps Platform API หรือ SDK หากต้องการสร้างคีย์ใหม่หรือเพิ่ม API หรือ SDK ลงในคีย์ที่มีอยู่ ให้ทำตามวิธีการต่อไปนี้

คอนโซล

  1. ไปที่หน้า Google Maps Platform > คีย์และข้อมูลเข้าสู่ระบบ

    ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ

  2. หากได้รับข้อความแจ้ง ให้เลือกโปรเจ็กต์

  3. ทำสิ่งใดสิ่งหนึ่งต่อไปนี้

    • สร้างคีย์ใหม่:

      1. คลิกสร้างข้อมูลเข้าสู่ระบบ > คีย์ API
      2. ในแผงสร้างคีย์ API ให้เปิดรายการเลือกข้อจำกัดของ API
      3. ล้าง API ที่คีย์นี้ไม่จำเป็นต้องใช้ และตรวจสอบว่าได้เลือก Time Zone API ไว้
      4. คลิกสร้าง แผงจะแสดงคีย์ API ใหม่

    • ใช้คีย์ที่มีอยู่

      1. คลิกชื่อคีย์
      2. ในรายการเลือกข้อจำกัด API ให้เลือก Time Zone API
      3. คลิกบันทึก

    การเลือก API ที่นี่ไม่ได้เป็นการเปิดใช้ API ตรวจสอบว่าเปิดใช้ Time Zone API แล้วในหน้าคลัง API

  4. หากต้องการดูสตริงคีย์ในภายหลัง ให้ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ แล้วคลิกแสดงคีย์สำหรับคีย์นั้น

หากคอนโซลดูแตกต่างจากขั้นตอนเหล่านี้ โปรดดูหัวข้อสร้างคีย์ API และเพิ่มข้อจำกัด API ในเอกสารประกอบของ Google Cloud

gcloud

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ในคำสั่งต่อไปนี้

  • สร้างคีย์ใหม่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ DISPLAY_NAME ด้วยชื่อคีย์ 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=timezone-backend.googleapis.com

    อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

  • ใช้คีย์ที่มีอยู่: เรียกใช้คำสั่งต่อไปนี้ และแทนที่ KEY_ID ด้วยรหัสของคีย์ แฟล็ก --append จะเก็บ API ที่คีย์อนุญาตไว้แล้ว หากไม่มีตัวเลือกนี้ คำสั่งจะแทนที่ตัวเลือกเหล่านั้น

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=timezone-backend.googleapis.com

    อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้

    รหัสคีย์ไม่ใช่สตริงคีย์หรือชื่อที่แสดง หากต้องการค้นหา ให้เรียกใช้ gcloud services api-keys list --project="PROJECT_ID" รหัสคือส่วนสุดท้ายของช่อง name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID

หากต้องการดูสตริงคีย์ ให้เรียกใช้ gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID"

ส่งคำขอ API

ส่งคำขอ Time Zone API เพื่อแสดงผลการตอบกลับ JSON ที่มีข้อมูลเขตเวลาสำหรับเนวาดา สหรัฐอเมริกา การประทับเวลาตั้งค่าเป็นวันที่ 5 ธันวาคม 2024 คุณต้องใส่สตริงตัวอักษรและตัวเลขคละกันของคีย์ API ในทุกคำขอ และใช้ HTTPS สำหรับคำขอที่มีคีย์ API

  1. คลิก API_KEY ในโค้ดด้านล่างเพื่อแทรกสตริงตัวอักษรและตัวเลขคละกันของคีย์

    curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'
  2. คลิกไอคอนคัดลอกในตัวอย่างโค้ด เลือกไอคอนคัดลอก เพื่อคัดลอกคำสั่ง curl
  3. วางคำสั่งในหน้าต่างเทอร์มินัลและเรียกใช้คำสั่ง

การตอบกลับเป็นออบเจ็กต์ JSON ในรูปแบบต่อไปนี้

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}

ใช้ข้อจำกัดของคีย์ API

Google ขอแนะนำอย่างยิ่งให้คุณจำกัดคีย์ API โดยจำกัดการใช้งานเฉพาะกับ API และแอปที่จำเป็นต้องใช้เท่านั้น การจำกัดคีย์ API จะเพิ่มความปลอดภัยให้กับแอปพลิเคชันโดยการปกป้องแอปพลิเคชันจากคำขอที่ไม่ได้รับอนุญาต คีย์ API รองรับข้อจำกัด 2 ประเภท ได้แก่

  • ข้อจำกัดของ API ระบุ SDK และ API ที่เรียกใช้ได้โดยใช้คีย์ API คอนโซลและ gcloud CLI ต้องมีข้อจำกัด API อย่างน้อย 1 รายการเมื่อคุณสร้างคีย์
  • ข้อจำกัดของแอปพลิเคชันจะระบุเว็บไซต์, ที่อยู่ IP หรือแอปที่ใช้คีย์ API ได้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ข้อจำกัดได้ที่จำกัดคีย์ API

ขั้นตอนถัดไป

เมื่อเปิดใช้ Time Zone API และส่งคำขอสำเร็จแล้ว โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ API ในหัวข้อคำขอและการตอบกลับของ Time Zone API