AG
WARRIOR SEO • SOP MANUAL How-To & Fact Only

คู่มือการสร้าง Service Account (GCP) & ติดตั้งใน Antigravity

คู่มือ Ubersuggest MCP ไปยัง Requirement 01
TECHNICAL SOP: SERVICE ACCOUNT & DATA INTEGRATION

ข้อเท็จจริงทางเทคนิค (Technical Fact) & วิธีการตั้งค่าทีละขั้นตอน

ระบบการดึงข้อมูล Search Engine แบบอัตโนมัติใน Antigravity ใช้กลไก Google Service Account (OAuth 2.0 Server-to-Server) โดยเชื่อมต่อผ่าน Search Console API และ Analytics Data API เพื่อดึงตัวเลข Clicks, Impressions, CTR และ Average Position ย้อนหลังมาวิเคราะห์โดยไม่ต้องใช้รหัสผ่านส่วนตัว

การยืนยันตัวตน (Authentication):
Private Key (JSON File)
ใช้ไฟล์ Credentials เก็บในเครื่อง ห้าม Commit ขึ้น Git
ระดับสิทธิ์ใน Google Search Console:
Restricted (อ่านอย่างเดียว)
เข้าถึงสถิติการค้นหา ไม่สามารถแก้ไขหรือลบ URL ได้
ระดับสิทธิ์ใน Google Analytics 4:
Viewer (ผู้ชม)
ดึงค่า Engagement Time และ Conversion เพื่อประเมิน On-page
01
HOW-TO • GOOGLE CLOUD PLATFORM

วิธีสร้าง Service Account & Private Key (JSON) บน Google Cloud Console

ขั้นตอนสำหรับผู้ดูแลระบบหรือ Developer ในการสร้าง Identity และกุญแจลับใหม่ตั้งแต่ต้น

STEP 1.1 — สร้าง Google Cloud Project เข้าหน้าคอนโซล: console.cloud.google.com
สร้าง Project ใหม่ใน GCP

1. เข้าที่ Google Cloud Console
2. คลิกเมนู Dropdown เลือกโปรเจกต์ที่แถบด้านบนซ้าย แล้วกดปุ่ม "New Project"
3. ตั้งชื่อโปรเจกต์แบบสากลตามชื่อธุรกิจหรือเว็บไซต์ของคุณ (เช่น seo-analytics-bridge หรือ [your-brand]-seo-data) แล้วกดปุ่ม "Create"

STEP 1.2 — เปิดใช้งาน APIs ที่จำเป็น เข้าหน้า Library: console.cloud.google.com/apis/library
เปิด Search Console API และ Analytics Data API

ไปที่เมนู APIs & Services ➔ Library ค้นหาและกด "Enable" ทั้ง 2 รายการต่อไปนี้:

1. Google Search Console API
ID: searchconsole.googleapis.com
ใช้ดึง Clicks, Impressions, CTR, Position รายวัน/รายหน้า
2. Google Analytics Data API
ID: analyticsdata.googleapis.com
ใช้ดึง Active Users, Engagement Time และ Conversions ใน GA4
STEP 1.3 — สร้างบัญชีบริการ (Service Account) เข้าหน้ารายการ: console.cloud.google.com/iam-admin/serviceaccounts
สร้าง Identity ประจำระบบ

1. ไปที่เมนู IAM & Admin ➔ Service Accounts
2. กดปุ่ม "+ Create Service Account" ที่แถบด้านบน
3. กรอกข้อมูล:

• Service account name: ตั้งชื่อสากลที่ระบุหน้าที่ เช่น seo-data-agent หรือ analytics-bridge
• Service account ID: ระบบจะสร้างอีเมล เช่น seo-data-agent@[project-id].iam.gserviceaccount.com
• Description: Agentic AI Data Bridge for SEO & Analytics
• กดปุ่ม "Create and Continue" (ในส่วนสิทธิ์ Project สามารถกดข้ามได้) แล้วกด "Done"
STEP 1.4 — สร้าง Private Key (JSON) และดาวน์โหลด
สร้างกุญแจลับสำหรับเชื่อมต่อระบบอัตโนมัติ

1. ในหน้ารายการ Service Accounts ให้คลิกที่ Email ของ Service Account ที่เพิ่งสร้าง
2. คลิกสลับไปที่แท็บ "Keys" (คีย์)
3. กดปุ่ม "Add Key" ➔ เลือก "Create new key"
4. เลือก Key type เป็น JSON แล้วกดปุ่ม "Create"
5. เบราว์เซอร์จะดาวน์โหลดไฟล์ .json มายังเครื่องทันที (ให้เก็บรักษาไฟล์นี้ไว้อย่างปลอดภัย ห้ามส่งต่อในช่องทางสาธารณะ)

STEP 1.5 — การติดตั้ง Key ใน Workspace Antigravity & ความปลอดภัย Git
ตำแหน่งจัดเก็บไฟล์และกฎเหล็กการล็อก `.gitignore`

นำไฟล์ JSON ที่ดาวน์โหลดมา เปลี่ยนชื่อให้สั้นลง เช่น credentials.json หรือ service_account.json แล้ววางไว้ในโฟลเดอร์ Workspace ของคุณ:

./credentials/service_account.json
กฎเหล็กความปลอดภัย Git (Critical Git Security Rule):

ต้องเพิ่มพาธของไฟล์ Credentials ลงในไฟล์ .gitignore ของโปรเจกต์เสมอ เพื่อป้องกันไม่ให้เผลออัปโหลดกุญแจลับขึ้น GitHub สาธารณะ: 

# ป้องกัน Private Key หลุดขึ้น GitHub
credentials/
*.json
!package*.json
!credentials.example.json
💡 ข้อสังเกตสำหรับผู้เรียน: หากคุณใช้งานวิเคราะห์เฉพาะในเครื่องของตัวเอง (ไม่ได้เชื่อมต่อหรืออัปโหลดขึ้น GitHub) ไม่จำเป็นต้องติดตั้ง Git ก็สามารถสั่ง Antigravity รันงานได้ทันที แต่หากในอนาคตต้องการเชื่อมต่อ GitHub แนะนำให้ติดตั้ง Git ตามขั้นตอนด้านล่างนี้
ขั้นตอนการตรวจสอบ & ติดตั้ง Git สำหรับผู้เรียน
Prerequisite

สำหรับผู้เรียนที่ต้องการใช้ฟีเจอร์เวอร์ชันคอนโทรล (บันทึกประวัติโค้ด, แบคอัปไฟล์ หรือเชื่อมต่อกับ GitHub) ให้ทำตาม 3 ขั้นตอนนี้:

ขั้นที่ 1 — เช็กผ่านเมนูง่ายๆ
คลิกเมนู Source Control

คลิกที่ไอคอน Source Control (รูปกิ่งก้าน Git) แถบเมนูด้านซ้ายสุดของ Antigravity IDE (ไม่ต้องเข้า Terminal):

• ถ้ามี Git แล้ว: แสดงสถานะกิ่งและไฟล์พร้อมใช้งาน
• ถ้ายังไม่มี: จะมีปุ่มขึ้นแนะนำให้กดดาวน์โหลดได้ทันที
ขั้นที่ 2 — ดาวน์โหลด
ดาวน์โหลดตัวติดตั้ง

หากเครื่องยังไม่มี ให้เข้าเว็บไซต์ทางการ:

git-scm.com/download/win

เลือกดาวน์โหลดแบบ 64-bit Git for Windows Setup

ขั้นที่ 3 — ติดตั้ง
เปิดติดตั้งตามค่าเริ่มต้น

เปิดไฟล์ .exe ที่ดาวน์โหลดมา กด Next ตามค่าเริ่มต้น (Recommended Defaults) ไปจนเสร็จสิ้น

ปิดแล้วเปิด Antigravity IDE ใหม่อีก 1 ครั้ง ระบบจะตรวจพบ Git อัตโนมัติ

หมายเหตุ: หากผู้เรียนใช้งานวิเคราะห์ข้อมูลเฉพาะในเครื่องตัวเอง (ไม่ได้เชื่อมต่อหรืออัปโหลดขึ้น GitHub) ไม่จำเป็นต้องติดตั้ง Git ก็สามารถสั่ง Antigravity รันสคริปต์ได้ทันทีครับ
ส่วนเสริมแนะนำ: Extension 'Antigravity Quota' สำหรับมอนิเตอร์โควตา AI บน Status Bar

1. ใน Antigravity IDE กดปุ่ม Ctrl + Shift + X เพื่อเปิดหน้า Extensions
2. ค้นหา Antigravity Quota แล้วกด Install
3. ฟังก์ชันทางเทคนิค: แสดงจำนวนโควตา Requests และ Tokens คงเหลือของโมเดล AI พร้อมเวลานับถอยหลังรอบรีเซ็ตที่ Status bar ด้านล่าง ช่วยวางแผนการรันงานได้อย่างต่อเนื่อง

สั่งงานด้วยภาษาธรรมชาติได้ทันที (Zero MCP Configuration)
No MCP Required

เมื่อมี Service Account Email (ที่ได้รับสิทธิ์ใน GSC/GA4) และไฟล์ JSON Key วางไว้ในเครื่องแล้ว ไม่จำเป็นต้องติดตั้งหรือตั้งค่า MCP Server ให้ยุ่งยาก คุณสามารถพิมพ์สั่งงาน Antigravity ในช่องแชตด้วยภาษาธรรมชาติได้ทันที ระบบจะเขียนสคริปต์เชื่อมต่อ API ดึงข้อมูล และประมวลผลวิเคราะห์ให้เสร็จสรรพ:

"ช่วยดึงข้อมูล Search Console ย้อนหลัง 90 วันจากไฟล์ credentials แล้วหาหน้าที่ Impressions สูงแต่ CTR ต่ำกว่า 2%"
"เชื่อมต่อ GA4 และ GSC เพื่อวิเคราะห์ว่าหน้าไหนมีปัญหา Traffic ตกหลังเผยแพร่ไปแล้ว 60 วัน พร้อมระบุสาเหตุ On-page"
"สรุป 20 อันดับ Search Queries ที่มี Organic Clicks สูงสุด และวิเคราะห์ว่ามีโอกาสขยายเป็น Topic Cluster อะไรได้บ้าง"
02
HOW-TO • GOOGLE SEARCH CONSOLE

วิธีมอบสิทธิ์ Service Account ใน Google Search Console (GSC)

ทำตาม 4 ขั้นตอนด้านล่างนี้ในบัญชี GSC ของเว็บไซต์ที่ต้องการวิเคราะห์

Service Account Email สำหรับนำไปมอบสิทธิ์ (คลิกเพื่อคัดลอก)

นำ Email นี้ไปใส่ใน GSC (STEP 2.4) และ GA4 (STEP 3.2)

warrior-in-th@gen-lang-client-0042204106.iam.gserviceaccount.com
STEP 2.1
เข้าสู่ระบบ GSC

เข้าเว็บไซต์ search.google.com แล้วเลือก Property เว็บไซต์ที่ต้องการ

STEP 2.2
ไปที่เมนูตั้งค่า

คลิกเมนูด้านซ้ายล่าง Settings (การตั้งค่า) ➔ เลือก Users and permissions (ผู้ใช้และสิทธิ์)

STEP 2.3
กด Add User

กดปุ่มสีน้ำเงิน "Add User (เพิ่มผู้ใช้)" ที่มุมบนขวาของตารางรายชื่อ

STEP 2.4
วาง Email & กำหนดสิทธิ์

วาง Service Account Email แล้วกำหนด Permission เป็น Restricted แล้วกด Add

ข้อเท็จจริงสิทธิ์ Restricted: เป็นสิทธิ์อ่านรายงานเชิงสถิติเท่านั้น ไม่สามารถยื่นลบ URL, ไม่สามารถแก้ไข Sitemap และไม่สามารถลบเจ้าของเว็บได้ จึงปลอดภัย 100%
03
HOW-TO • GOOGLE ANALYTICS 4

วิธีมอบสิทธิ์ใน Google Analytics 4 (GA4)

เพิ่มสิทธิ์ Viewer ในระดับ Property เพื่อให้สคริปต์สามารถอ่าน Engagement Time และ Pogo-sticking rate ได้

STEP 3.1
เข้า Admin ของ GA4

เข้า analytics.google.com แล้วกดรูปเฟือง Admin (ผู้ดูแลระบบ) ที่มุมซ้ายล่าง

STEP 3.2
เพิ่มสิทธิ์ระดับ Property

เลือก Property Access Management ➔ กดปุ่ม (+) ➔ เลือก Add users ➔ วาง Service Account Email ➔ กำหนด Role เป็น Viewer แล้วกดบันทึก

หมายเหตุสำหรับลูกค้า: เมื่อมอบสิทธิ์ระดับ Viewer เรียบร้อยแล้ว ผู้สอนและสคริปต์ Antigravity จะสามารถดึง Property ID และรายงานสถิติได้เองจากระบบอัตโนมัติ โดยลูกค้าไม่จำเป็นต้องค้นหาหรือส่งเลข ID ให้
04
SECURITY & COMPLIANCE FACTS

ข้อเท็จจริงด้านความปลอดภัยสำหรับส่งให้ทีมไอที / ผู้บริหาร

3 มาตรฐานความปลอดภัยตามข้อกำหนดของ Google Enterprise Security

1. Zero Password Sharing

ไม่ต้องเปิดเผยรหัสผ่าน Gmail, รหัสโฮสติ้ง, หรือรหัสแอดมิน WordPress ใช้ระบบมอบสิทธิ์แยกเฉพาะ Service Account เท่านั้น

2. Read-Only Privilege

สิทธิ์ที่มอบให้คือ Restricted (ใน GSC) และ Viewer (ใน GA4) ไม่สามารถแก้ไขโครงสร้างเว็บ หรือสร้างความเสียหายใดๆ ได้

3. Revocable Anytime

เมื่อเสร็จสิ้นโครงการฝึกอบรม หรือเมื่อใดก็ตามที่ต้องการ ผู้ว่าจ้างสามารถกดปุ่ม "Remove Access (ลบสิทธิ์)" ใน GSC/GA4 ได้ทันทีเพียงคลิกเดียว

เช็กลิสต์ความพร้อมก่อนเริ่มเรียน (Readiness Checklist)

ติ๊กเพื่อบันทึกสถานะ (ระบบจดจำสถานะในเบราว์เซอร์อัตโนมัติ)

0 / 3 เสร็จสิ้น
ไปยัง Requirement 01 ทันที