Google 致力于为黑人社区推动种族平等。查看具体举措
Эта страница переведена с помощью Cloud Translation API.
Switch to English

Отправляйте сообщения с помощью консоли Firebase

Вы можете отправлять уведомления с помощью композитора уведомлений в консоли Firebase. Хотя это не обеспечивает такой же гибкости или масштабируемости, как отправка сообщений с помощью Admin SDK или протоколов HTTP и XMPP , это может быть очень полезно для тестирования или для целенаправленного маркетинга и взаимодействия с пользователями. Консоль Firebase обеспечивает A / B-тестирование на основе аналитики, чтобы помочь уточнить и улучшить маркетинговые сообщения.

После того как вы разработали в своем приложении логику для получения сообщений, вы можете разрешить нетехническим пользователям отправлять сообщения в соответствии с инструкциями на странице уведомлений в Справочном центре Firebase.

Около

Когда вы отправляете уведомление от компоновщика уведомлений , Google использует значения, которые вы вводите в поля формы, следующим образом:

  • Такие поля, как Пользовательский сегмент и Срок действия, определяют цель сообщения и параметры доставки.
  • Такие поля, как текст уведомления и пользовательские данные , отправляются клиенту в виде полезной нагрузки, состоящей из пар ключ / значение.

Эти поля соответствуют ключам, доступным через протоколы сервера FCM. Например, пары ключ / значение, введенные в пользовательские данные , обрабатываются как полезные данные для уведомления. Другие поля отображаются непосредственно на ключи в полезных данных уведомления FCM.

Обратите внимание , что некоторые поля композитора Notifications не доступны через протоколы FCM сервера. Например, вы можете настроить таргетинг на сегменты пользователей на основе версии приложения, языка, типа и версии браузера или свойств пользователя способами, которые недоступны с помощью поля to в API сервера.

Ключи, которые консоль Firebase отправляет клиентам:

Ключ Метка поля консоли Описание
notification.title Название уведомления Обозначает заголовок уведомления.
notification.body Текст уведомления Обозначает основной текст уведомления.
data Пользовательские данные Пары ключ / значение, которые вы определяете. Они доставляются как полезные данные для обработки приложением.

Ключи, определяющие доставку сообщения, включают:

Ключ Метка поля консоли Описание
sound Звук

Обозначает звук, который должен воспроизводиться, когда устройство получает уведомление.

time_to_live Истекает

Этот параметр указывает, как долго (в секундах) сообщение должно храниться в хранилище FCM, если устройство отключено. Для получения дополнительной информации см. Установка срока жизни сообщения .

Журналы аудита

На этой странице описаны журналы аудита, созданные Firebase как часть журналов аудита облака .

Обзор

Службы Firebase ведут журналы аудита, чтобы помочь вам ответить на вопросы: «Кто что сделал, где и когда?» Это журналы облачного аудита, предоставляемые как часть проекта Google Cloud, подключенного к вашему проекту Firebase . Каждый из ваших проектов Firebase содержит только журналы аудита для ресурсов, которые находятся непосредственно в проекте.

Чтобы получить общий обзор журналов аудита облака, перейдите в Журналы аудита облака . Для более глубокого понимания журналов аудита облака см. Раздел « Общие сведения о журналах аудита» .

Cloud Audit Logs ведет три журнала аудита для каждого проекта, папки и организации Google Cloud:

  • Журналы аудита активности администратора
  • Журналы аудита доступа к данным
  • Журналы аудита системных событий

Консоль уведомлений Firebase записывает журналы аудита доступа к данным только в том случае, если она явно включена. Журналы аудита доступа к данным содержат вызовы API, которые считывают конфигурацию или метаданные ресурсов, а также управляемые пользователем вызовы API, которые создают, изменяют или читают данные ресурсов, предоставленные пользователем. Журналы аудита доступа к данным не регистрируют операции доступа к данным для ресурсов, которые являются общедоступными (доступны всем пользователям или всем прошедшим проверку пользователям ) или к которым можно получить доступ без входа в Google Cloud.

Консоль уведомлений Firebase не записывает журналы аудита активности администратора .

Консоль уведомлений Firebase не записывает журналы аудита системных событий .

Проверенные операции

Ниже приводится сводная информация о том, какие операции API соответствуют каждому типу журнала аудита в консоли уведомлений Firebase:

Категория журналов аудита Действия консоли Firebase Notifications Имя типа (используется для поиска журналов в пользовательском интерфейсе)
Журналы доступа к данным (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 с помощью средства просмотра журналов, Stackdriver Logging API или Cloud SDK, включают следующие объекты:

  • Сама запись журнала, которая является объектом типа LogEntry . К полезным полям относятся следующие:

    • logName содержит идентификацию проекта и тип журнала аудита
    • resource содержит цель проверяемой операции
    • timeStamp содержит время проверенной операции
    • protoPayload содержит проверенную информацию
  • Ведение журнала аудита данных, который являетсяAuditLog объект удерживается в protoPayload поле записи журнала.

  • Необязательная информация аудит конкретной службы, которая является объектом конкретной службы провел в serviceData поле AuditLog объекта. Дополнительные сведения см. В разделе «Данные аудита конкретной службы» .

Информацию о других полях в этих объектах, а также о том, как их интерпретировать, см. В разделе Общие сведения о журналах аудита .

Имя журнала

Имена ресурсов Cloud Audit Logs указывают на проект или другую сущность, которая владеет журналами аудита, а также на то, содержит ли журнал данные журнала аудита действий администратора, доступа к данным или системных событий. Например, ниже показаны имена журналов для журналов аудита действий администратора проекта и журналов аудита доступа к данным организации:

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

Наименование услуги

Журналы аудита консоли уведомлений Firebase используют имя службы gcmcontextualcampaign-pa.googleapis.com .

Дополнительные сведения о службах ведения журналов см. В разделе Службы сопоставления с ресурсами .

Типы ресурсов

Журналы аудита консоли уведомлений Firebase используют тип ресурса audited_resource для всех журналов аудита.

Чтобы увидеть полный список, перейдите в Контролируемые типы ресурсов .

Включить ведение журнала аудита

Журналы аудита доступа к данным отключены по умолчанию и не записываются, если явно не включены (исключением являются журналы аудита доступа к данным для BigQuery, которые нельзя отключить).

Инструкции по включению некоторых или всех журналов аудита доступа к данным см. В разделе Настройка журналов доступа к данным .

Включенные вами журналы аудита доступа к данным могут повлиять на стоимость ваших журналов в Stackdriver. Просмотрите раздел цен на этой странице.

Консоль уведомлений Firebase не записывает журналы аудита активности администратора.

Разрешения журнала аудита

Разрешения и роли Cloud Identity и Access Management определяют, какие журналы аудита вы можете просматривать или экспортировать. Журналы находятся в проектах и ​​некоторых других объектах, включая организации, папки и платежные аккаунты. Для получения дополнительной информации перейдите к пониманию ролей .

Для просмотра журналов аудита доступа к данным у вас должна быть одна из следующих ролей в проекте, который содержит ваши журналы аудита:

Если вы используете журналы аудита не относящейся к проекту сущности, например организации, измените роли проекта на подходящие роли организации.

Просмотр журналов

У вас есть несколько вариантов просмотра записей журнала аудита:

Базовый просмотрщик

Вы можете использовать базовый интерфейс средства просмотра журналов в консоли GCP для получения записей журнала аудита. Сделайте следующее:

  1. Перейдите на страницу Stackdriver Logging> Logs (Logs Viewer) в консоли GCP:

    Перейдите на страницу просмотра журналов

  2. Выберите существующий проект Google Cloud вверху страницы или создайте новый проект.

  3. В первом раскрывающемся меню выберите тип ресурса, журналы аудита которого вы хотите просмотреть. Вы можете выбрать конкретный ресурс или Global для всех ресурсов.

  4. Во втором раскрывающемся меню выберите тип журнала, который вы хотите просмотреть: activity для журналов аудита activity администратора, data_access для журналов аудита доступа к данным и system_events для журналов аудита системных событий.

    Если ни один из этих параметров не отображается, значит, в проекте нет журналов аудита этого типа.

Расширенный просмотрщик

Вы можете использовать расширенный интерфейс средства просмотра журналов в консоли GCP для получения записей журнала аудита. Сделайте следующее:

  1. Перейдите на страницу Stackdriver Logging> Logs (Logs Viewer) в консоли GCP:

    Перейдите на страницу просмотра журналов

  2. Выберите существующий проект Google Cloud вверху страницы или создайте новый проект.

  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. Щелкните Выполнить .

Дополнительные сведения о запросах см. В разделе « Расширенные запросы журналов» .

SDK

Чтобы прочитать записи журнала с помощью 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, вы можете экспортировать в другие приложения, другие репозитории и третьим лицам.

  • Чтобы управлять журналами аудита во всей организации, вы можете создать агрегированные приемники экспорта, которые могут экспортировать журналы из любого или всех проектов в организации.

  • Если ваши включенные журналы аудита доступа к данным подталкивают ваши проекты к выделенным им журналам, вы можете экспортировать и исключить журналы аудита доступа к данным из ведения журнала. Подробнее см. Исключение журналов .

Ценообразование

Stackdriver Logging взимает плату за явно запрашиваемые вами журналы аудита доступа к данным. Консоль уведомлений Firebase не записывает журналы аудита действий администратора или журналы аудита системных событий.

Для получения дополнительной информации о ценах на журналы аудита ознакомьтесь с ценами на Stackdriver .