Method: projects.addGoogleAnalytics

เชื่อมโยง FirebaseProject ที่ระบุกับ บัญชี Google Analytics ที่มีอยู่

เมื่อใช้สายนี้ คุณสามารถ:

  • ระบุ analyticsAccountId เพื่อจัดสรรพร็อพเพอร์ตี้ Google Analytics ใหม่ภายในบัญชีที่ระบุ และเชื่อมโยงพร็อพเพอร์ตี้ใหม่กับ FirebaseProject
  • ระบุ analyticsPropertyId ที่มีอยู่เพื่อเชื่อมโยงพร็อพเพอร์ตี้กับ FirebaseProject

โปรดทราบว่าเมื่อคุณเรียก projects.addGoogleAnalytics :

  1. การตรวจสอบครั้งแรกจะกำหนดว่าสตรีมข้อมูลที่มีอยู่ในพร็อพเพอร์ตี้ Google Analytics สอดคล้องกับแอป Firebase ที่มีอยู่ใน FirebaseProject หรือไม่ (ขึ้นอยู่กับ packageName หรือ bundleId ที่เชื่อมโยงกับสตรีมข้อมูล) จากนั้นสตรีมข้อมูลและแอปจะเชื่อมโยงตามความเหมาะสม โปรดทราบว่าการเชื่อมโยงอัตโนมัตินี้ใช้กับ AndroidApps และ IosApps เท่านั้น
  2. หากไม่พบสตรีมข้อมูลที่เกี่ยวข้องสำหรับแอป Firebase ระบบจะจัดเตรียมสตรีมข้อมูลใหม่ในพร็อพเพอร์ตี้ Google Analytics สำหรับแอป Firebase แต่ละรายการ โปรดทราบว่าสตรีมข้อมูลใหม่จะได้รับการจัดเตรียมสำหรับ Web App เสมอ แม้ว่าก่อนหน้านี้จะเชื่อมโยงกับสตรีมข้อมูลในพร็อพเพอร์ตี้ Analytics ก็ตาม

เรียนรู้เพิ่มเติมเกี่ยวกับลำดับชั้นและโครงสร้างของบัญชี Google Analytics ใน เอกสารประกอบของ Analytics

ผลลัพธ์ของการโทรนี้คือ Operation สำรวจ Operation เพื่อติดตามกระบวนการจัดเตรียมโดยการเรียก operations.get จนกระทั่ง done เป็น true เมื่อ done เป็น true Operation จะสำเร็จหรือล้มเหลว หาก Operation สำเร็จ response จะถูกตั้งค่าเป็น AnalyticsDetails หาก Operation ล้มเหลว error จะถูกตั้งค่าเป็น google.rpc.Status

หากต้องการเรียก projects.addGoogleAnalytics สมาชิกโปรเจ็กต์จะต้องเป็นเจ้าของ FirebaseProject ที่มีอยู่ และมี สิทธิ์ Edit สำหรับบัญชี Google Analytics

หาก FirebaseProject เปิดใช้งาน Google Analytics แล้ว และคุณเรียกใช้ projects.addGoogleAnalytics โดยใช้ analyticsPropertyId ที่แตกต่างจากพร็อพเพอร์ตี้ที่เกี่ยวข้องในปัจจุบัน การเรียกจะล้มเหลว อาจเปิดใช้งาน Analytics แล้วในคอนโซล Firebase หรือโดยการระบุ timeZone และ regionCode ในการเรียกไปยัง projects.addFirebase

คำขอ HTTP

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics

URL ใช้ไวยากรณ์ การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ชื่อทรัพยากรของ FirebaseProject ที่จะเชื่อมโยงกับบัญชี Google Analytics ที่มีอยู่ ในรูปแบบ:

projects/ PROJECT_IDENTIFIER

โปรดดูช่อง name FirebaseProject สำหรับรายละเอียดเกี่ยวกับค่า PROJECT_IDENTIFIER

ขอร่างกาย

เนื้อหาคำขอประกอบด้วยข้อมูลที่มีโครงสร้างดังต่อไปนี้:

การเป็นตัวแทน JSON
{

  // Union field analytics_resource can be only one of the following:
  "analyticsAccountId": string,
  "analyticsPropertyId": string
  // End of list of possible types for union field analytics_resource.
}
เขตข้อมูล
Union ฟิลด์ analytics_resource

สามารถระบุทรัพยากร Google Analytics ได้เพียงรายการเดียวในเนื้อหาคำขอ
  • หากต้องการจัดเตรียมพร็อพเพอร์ตี้ Google Analytics ใหม่และเชื่อมโยงกับ FirebaseProject ให้ระบุ analyticsAccountId
  • หากต้องการเชื่อมโยงพร็อพเพอร์ตี้ Google Analytics ที่มีอยู่กับ FirebaseProject ให้ระบุ analyticsPropertyId


analytics_resource สามารถมีได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้:
analyticsAccountId

string

รหัสสำหรับ บัญชี Google Analytics ที่มีอยู่ที่คุณต้องการเชื่อมโยงกับ FirebaseProject

การระบุช่องนี้จะจัดเตรียมพร็อพเพอร์ตี้ Google Analytics ใหม่ในบัญชี Google Analytics ของคุณและเชื่อมโยงพร็อพเพอร์ตี้ใหม่กับ FirebaseProject

analyticsPropertyId

string

รหัสสำหรับพร็อพเพอร์ตี้ Google Analytics ที่มีอยู่ที่คุณต้องการเชื่อมโยงกับ FirebaseProject

ร่างกายตอบสนอง

หากสำเร็จ เนื้อหาการตอบสนองจะมีอินสแตนซ์ของ Operation

ขอบเขตการอนุญาต

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

สำหรับข้อมูลเพิ่มเติม โปรดดู ภาพรวมการตรวจสอบสิทธิ์