Melaksanakan Penghantaran Gmail dengan Cloudflare Workers - Panduan Persediaan

Ini ialah Bahagian 1 siri pelaksanaan penghantaran Gmail dengan Cloudflare Workers:

• Bahagian 1: Persediaan (Semasa)
• Bahagian 2: Persekitaran Pembangunan (Akan Datang)
• Bahagian 3: Pelaksanaan (Akan Datang)

pengenalan

Apabila melaksanakan borang hubungan pada tapak web statik yang dihoskan pada Cloudflare Pages, fungsi penghantaran e-mel memerlukan penyelesaian tanpa pelayan. Panduan ini menunjukkan cara menyediakan API Gmail dengan Cloudflare Workers untuk mengendalikan penyerahan borang.

Kekangan Pekerja Cloudflare

Apabila bekerja dengan Cloudflare Workers, terdapat dua batasan utama yang perlu dipertimbangkan:

1. Pakej Google API Tidak Tersedia:

   • Cloudflare Workers bukan persekitaran Node.js
   • Permintaan HTTP terus ke titik akhir REST API Google mesti digunakan dan bukannya perpustakaan klien Node.js

2. Pakej Nodemailer Tidak Tersedia:

   • Nodemailer bergantung pada persekitaran Node.js
   • Tidak boleh digunakan dalam Cloudflare Workers

Proses Persediaan

1. Buat Akaun Perkhidmatan

1. Akses Google Cloud Console
2. Buat projek baharu atau pilih projek sedia ada
3. Navigasi ke "IAM & Admin" > "Akaun Perkhidmatan"
4. Klik "Buat Akaun Perkhidmatan"
5. Masukkan nama dan perihalan akaun perkhidmatan
6. Langkau tetapan pilihan dan klik "Selesai"
7. Perhatikan ID Klien OAuth2 untuk kegunaan kemudian

2. Berikan Peranan yang Diperlukan

1. Navigasi ke "IAM & Admin" > "IAM"
2. Pilih pengetua yang berkaitan
3. Klik "Berikan Akses"
4. Tambah akaun perkhidmatan sebagai pengetua baharu
5. Tugaskan peranan berikut:
   • Pentadbir Akaun Perkhidmatan
   • Pentadbir Kunci Akaun Perkhidmatan
   • Pencipta Token Akaun Perkhidmatan
   • Pentadbir Dasar IAP
6. Simpan perubahan

3. Dayakan API Gmail

1. Navigasi ke "API & Perkhidmatan" > "Perpustakaan"
2. Cari "gmail"
3. Pilih "API Gmail"
4. Klik "Dayakan"

4. Tambah Peranan Pentadbir Dasar Organisasi

1. Navigasi ke "IAM & Admin" > "IAM"
2. Edit pentadbir organisasi
3. Tambahkan peranan "Pentadbir Dasar Organisasi"
4. Simpan perubahan

5. Lumpuhkan Dasar Penciptaan Kunci Akaun Perkhidmatan

1. Navigasi ke "IAM & Admin" > "Dasar Organisasi"
2. Tapis untuk "iam.disableServiceAccountKeyCreation"
3. Klik pautan dasar
4. Klik "Urus Dasar"
5. Pilih "Timpa dasar induk"
6. Tambah peraturan dan tetapkan kepada "Dikuatkuasakan"
7. Klik "Selesai"

6. Jana Kunci Akaun Perkhidmatan

1. Navigasi ke "IAM & Admin" > "Akaun Perkhidmatan"
2. Pilih akaun perkhidmatan yang dibuat
3. Pergi ke tab "Kunci"
4. Klik "Tambah Kunci" > "Buat Kunci Baharu"
5. Pilih format JSON
6. Buat dan simpan fail JSON yang dimuat turun dengan selamat

7. Konfigurasikan Delegasi Seluruh Domain

1. Akses Konsol Pentadbiran Google Workspace
2. Navigasi ke Keselamatan > Akses dan Kawalan Data > Kawalan API
3. Klik "Urus Perwakilan Seluruh Domain"
4. Tambah ID pelanggan baharu:
   • Masukkan ID pelanggan akaun perkhidmatan
   • Tambah skop: https://www.googleapis.com/auth/gmail.send
5. Klik "Izinkan"

Nota: Delegasi seluruh domain harus dipertimbangkan dengan teliti dalam organisasi yang lebih besar kerana implikasi keselamatan.

Konfigurasi Tambahan

Apabila menghantar e-mel daripada alias Gmail, ingat untuk menambah alamat alias:

1. Pergi ke Tetapan Gmail > Akaun
2. Tambah alamat e-mel alias melalui "Tambah alamat e-mel lain"

Nota Penting Mengenai Perkhidmatan E-mel Percuma

Sebelum ini, MailChannels Send API telah disyorkan secara meluas sebagai penyelesaian penghantaran e-mel percuma untuk Cloudflare Workers. Walau bagaimanapun, pada 30 Jun 2024, penyepaduan antara MailChannels dan Cloudflare telah dihentikan. Ini telah menjejaskan banyak pembangun yang bergantung pada perkhidmatan ini untuk keperluan penghantaran e-mel mereka.

Banyak model bahasa AI masih mencadangkan MailChannels sebagai penyelesaian kerana data latihan mereka mendahului pemberhentian perkhidmatan ini. Keadaan ini menyerlahkan kepentingan mengesahkan ketersediaan perkhidmatan semasa, terutamanya apabila bekerja dengan penyepaduan pihak ketiga.

Pelaksanaan API Gmail yang diterangkan dalam panduan ini berfungsi sebagai alternatif yang boleh dipercayai, walaupun ia memerlukan lebih banyak persediaan awal berbanding dengan penyelesaian MailChannels sebelumnya.

Langkah Seterusnya

Artikel seterusnya dalam siri ini akan merangkumi butiran persediaan persekitaran pembangunan dan pelaksanaan untuk menggunakan API Gmail dengan Cloudflare Workers.

Atas ialah kandungan terperinci Melaksanakan Penghantaran Gmail dengan Cloudflare Workers - Panduan Persediaan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!