Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

使用Firebase控制台發送消息

您可以使用Firebase控制台中的Notifications作曲器發送通知消息。儘管這不能提供與使用Admin SDKHTTP和XMPP協議發送消息相同的靈活性或可伸縮性,但對於測試或針對性強的營銷和用戶參與而言,它可能非常有用。 Firebase控制台提供基於分析的A / B測試,以幫助改進和改善營銷信息。

在您的應用中開發出可以接收消息的邏輯之後,您可以允許非技術用戶按照Firebase幫助中心“ 通知”頁面中的說明發送消息。

關於

當您從Notifications作曲家發送通知消息時,Google會通過以下方式使用您在表單字段中輸入的值:

  • 使用者區隔有效期等欄位決定郵件目標和傳送選項。
  • 諸如通知文本自定義數據之類的字段會在由鍵/值對組成的有效負載中發送給客戶端。

這些字段映射到FCM服務器協議可用的密鑰。例如,在“ 自定義”數據中輸入的鍵/值對將作為通知的數據有效內容處理。其他字段直接映射到FCM 通知有效負載中的鍵。

請注意, Notifications編輯器中的某些字段無法通過FCM服務器協議使用。例如,您可以使用服務器API中的to字段以應用程序版本,語言,瀏覽器類型和版本或用戶屬性為目標的用戶細分,而這些方式是不可用的。

Firebase控制台發送給客戶端的密鑰是:

控制台字段標籤描述
notification.title 通知標題指示通知標題。
notification.body 通知文字指示通知正文文本。
data 自訂資料您定義的鍵/值對。這些作為數據有效載荷提供給應用程序處理。

確定郵件傳遞的鍵包括:

控制台字段標籤描述
sound 聲音

表示設備收到通知時播放的聲音。

time_to_live 過期

此參數指定如果設備處於脫機狀態,則消息應保留在FCM存儲中的時間(以秒為單位)。有關更多信息,請參閱設置消息的壽命

審核日誌

此頁面描述Firebase作為Cloud Audit Logs的一部分創建的審核日誌

總覽

Firebase服務會編寫審核日誌,以幫助您回答以下問題:“誰在什麼地方,何時何地進行了操作?”這些是Cloud Audit Logs,作為連接到Firebase項目GCP項目的一部分提供。每個Firebase項目僅包含直接在項目內的資源的審核日誌。

有關Cloud Audit Logs的一般概述,請轉到Cloud Audit Logs 。要更深入地了解Cloud Audit Logs,請查看了解審計日誌

Cloud Audit Logs為每個GCP項目,文件夾和組織維護三個審核日誌:

  • 管理員活動審核日誌
  • 數據訪問審核日誌
  • 系統事件審核日誌

只有明確啟用後,Firebase Notifications Console才會寫入數據訪問審核日誌。數據訪問審核日誌包含用於讀取資源的配置或元數據的API調用,以及用於創建,修改或讀取用戶提供的資源數據的用戶驅動的API調用。數據訪問審核日誌不會將數據訪問操作記錄在公共共享(對所有用戶所有經過身份驗證的用戶可用)或無需登錄GCP即可訪問的資源上。

Firebase Notifications Console不會寫入“ 管理員活動”審核日誌。

Firebase Notifications Console不會寫入系統事件審核日誌。

經審計的運營

以下總結了Firebase Notifications Console中與每種審核日誌類型相對應的API操作:

審核日誌類別 Firebase通知控制台操作鍵入名稱(用於在UI上搜索日誌)
數據訪問日誌(DATA_READ) 取得廣告活動 GetCampaign
數據訪問日誌(DATA_READ) 列出廣告活動 ListCampaign
數據訪問日誌(DATA_READ) 從ABT實驗通知中獲取信息 LegacyGetRollout
數據訪問日誌(DATA_READ) 獲取定位可能性 GetAudiences
數據訪問日誌(DATA_READ) 獲取fcm統計信息(已發送/已打開/已交付/已轉換計數) GetFcmStats
數據訪問日誌(DATA_READ) 獲取日期範圍和項目的分析標籤列表。 GetAnalyticsLabelList
數據訪問日誌(DATA_WRITE) 製作廣告活動 CreateCampaign
數據訪問日誌(DATA_WRITE) 刪除廣告活動 DeleteCampaign
數據訪問日誌(DATA_WRITE) 更新廣告活動 UpdateCampaign
數據訪問日誌(DATA_WRITE) 從ABT創建卷展欄 LegacyCreateRollout

審核日誌格式

審核日誌條目(可以使用日誌查看器,Stackdriver Logging API或Cloud SDK在Stackdriver Logging中查看)包括以下對象:

  • 日誌條目本身,它是LogEntry類型的對象。有用的字段包括:

    • logName包含項目標識和審核日誌類型
    • resource包含審計操作的目標
    • timeStamp包含審計操作的時間
    • protoPayload包含審核的信息
  • 審核日誌記錄數據,它是保存在日誌條目的protoPayload字段中的AuditLog對象。

  • 可選的特定於服務的審核信息,它是AuditLog對象的serviceData字段中保存的特定於服務的對象。有關詳細信息,請轉到特定服務的審核數據

有關這些對像中的其他字段,以及如何解釋它們,請查看《 了解審核日誌》

日誌名稱

Cloud Audit Logs資源名稱指示擁有審核日誌的項目或其他實體,以及該日誌是否包含Admin Activity,Data Access或System Event審核日誌數據。例如,以下內容顯示了項目的“管理員活動”審核日誌和組織的“數據訪問”審核日誌的日誌名稱:

projects/ [PROJECT_ID] /logs/cloudaudit.googleapis.com%2Factivity
organizations/ [ORGANIZATION_ID] /logs/cloudaudit.googleapis.com%2Fdata_access

服務名稱

Firebase Notifications Console審核日誌使用服務名稱gcmcontextualcampaign-pa.googleapis.com

有關日誌記錄服務的更多詳細信息,請轉到將服務映射到資源

資源類型

Firebase Notifications Console審核日誌對所有審核日誌使用資源類型audited_resource

有關完整列表,請轉至“ 監視的資源類型”

啟用審核日誌記錄

數據訪問審核日誌默認情況下處於禁用狀態,除非明確啟用,否則不會寫入(例外是BigQuery的數據訪問審核日誌,無法禁用)。

有關啟用部分或全部數據訪問審核日誌的說明,請轉到“ 配置數據訪問日誌”

啟用的數據訪問審核日誌可能會影響Stackdriver中的日誌定價。查看此頁面上的“ 定價”部分。

Firebase Notifications Console不會寫入“管理員活動”審核日誌。

審核日誌權限

雲身份和訪問管理權限和角色決定了您可以查看或導出的審核日誌。日誌位於項目和其他一些實體中,包括組織,文件夾和計費帳戶。有關更多信息,請轉到了解角色

若要查看數據訪問審核日誌,您必須在包含審核日誌的項目中具有以下角色之一:

如果您正在使用來自非項目實體(例如組織)的審核日誌,則將“ 項目”角色更改為合適的組織角色。

查看記錄

您可以使用多種方法查看審核日誌條目:

基本檢視器

您可以使用GCP控制台中的Logs Viewer基本界面來檢索審核日誌條目。請執行下列操作:

  1. 轉到GCP控制台中的Stackdriver Logging>日誌 (日誌查看器)頁面:

    轉到“日誌查看器”頁面

  2. 在頁面頂部選擇一個現有的GCP項目,或創建一個新項目。

  3. 在第一個下拉菜單中,選擇要查看其審核日誌的資源類型。您可以選擇特定資源或為所有資源選擇Global

  4. 在第二個下拉菜單中,選擇您要查看的日誌類型: activity的管理活動審計日誌, data_access數據訪問審計日誌,並system_events系統事件的審計日誌。

    如果未顯示這些選項,則項目中沒有該類型的審核日誌。

進階檢視器

您可以使用GCP控制台中的Logs Viewer高級界面來檢索審核日誌條目。請執行下列操作:

  1. 轉到GCP控制台中的Stackdriver Logging>日誌 (日誌查看器)頁面:

    轉到“日誌查看器”頁面

  2. 在頁面頂部選擇一個現有的GCP項目,或創建一個新項目。

  3. 在第一個下拉菜單中,選擇要查看其審核日誌的資源類型。您可以選擇特定資源或為所有資源選擇Global

  4. 點擊搜索過濾器框最右邊的下拉箭頭(▾),然後選擇轉換為高級過濾器

  5. 創建一個篩選器,以進一步指定要查看的日誌條目。要檢索項目中的所有審核日誌,請添加以下過濾器。在每個日誌名稱中提供有效的[PROJECT_ID]

       logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
     

    有關過濾器的更多詳細信息,請轉到高級日誌過濾器

API

要使用Stackdriver Logging API查看審核日誌條目,請執行以下操作:

  1. 請轉到文檔中的“ 嘗試使用此API”部分中的entries.list方法。

  2. 將以下內容放入“ 嘗試此API”表單的“ 請求”正文部分。單擊此預填充的表單會自動填充請求正文,但是您需要在每個日誌名稱中提供有效的[PROJECT_ID]

       {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
     
  3. 點擊執行

有關查詢的更多詳細信息,請轉到高級日誌查詢

開發包

要使用Cloud SDK閱讀日誌條目,請運行以下命令。在每個日誌名稱中提供有效的[PROJECT_ID]

 gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
 

轉到讀取日誌條目以獲取有關使用Cloud SDK的更多信息。

有關樣本審計日誌條目以及如何在其中找到最重要的信息,請轉到了解審計日誌

導出審核日誌

您可以採用與導出其他類型的日誌相同的方式導出審核日誌。有關如何導出日誌的詳細信息,請轉到“ 導出日誌” 。以下是導出審核日誌的一些應用程序:

  • 要保留審核日誌更長的時間或使用更強大的搜索功能,您可以將審核日誌的副本導出到Google Cloud Storage,BigQuery或Google Cloud Pub / Sub。使用Cloud Pub / Sub,您可以導出到其他應用程序,其他存儲庫和第三方。

  • 要在整個組織中管理審核日誌,可以創建聚合的導出接收器 ,這些導出接收器可以從組織中的任何或所有項目中導出日誌。

  • 如果啟用的Data Access審核日誌使項目超出其日誌分配,則可以從Logging中導出和排除Data Access審核日誌。有關詳細信息,請轉到排除日誌

價錢

Stackdriver Logging向您收取您明確請求的數據訪問審核日誌的費用。 Firebase Notifications Console不會寫入“管理員活動”審核日誌或“系統事件”審核日誌。

有關審核日誌定價的更多信息,請查看Stackdriver定價