Accounts.containers.workspaces.proposal: create

Создает предложение рабочей области для Google Менеджера тегов. Попробовать

Запрос

HTTP-запрос

POST https://www.googleapis.com/tagmanager/v2/+parent/proposal

Параметры

Название параметра Значение Описание
Параметры пути
parent string Относительный путь для API к рабочей области Менеджера тегов. Пример: accounts/{aid}/containers/{cid}/workspace/{wid}.

Тело запроса

В теле запроса требуется предоставить следующую структуру данных:

{
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "initialComment": {
    "content": string
  }
}
Название свойства Значение Описание Примечания
reviewers[] list Список пользователей, проверяющих предложение рабочей области.
reviewers[].type string Ими могут быть обычные пользователи или система Google Менеджера тегов.

Допустимые значения:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов.
initialComment nested object Первый комментарий (если есть), который следует связывать с предложением.
initialComment.content string Содержание комментария автора или проверяющего.

Ответ

В случае успеха метод возвращает тело ответа со следующей структурой:

{
  "path": string,
  "status": string,
  "authors": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "history": [
    {
      "type": string,
      "comment": {
        "content": string
      },
      "statusChange": {
        "oldStatus": string,
        "newStatus": string
      },
      "createdBy": {
        "type": string,
        "gaiaId": long
      },
      "createdTimestamp": {
        "seconds": long,
        "nanos": integer
      }
    }
  ],
  "fingerprint": string
}
Название свойства Значение Описание Примечания
path string Относительный путь к предложенной рабочей области Google Менеджера тегов.
status string Статус предложения в процессе рассмотрения.

Допустимые значения:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
authors[] list Список авторов предложенной рабочей области.
authors[].type string Ими могут быть обычные пользователи или система Google Менеджера тегов.

Допустимые значения:
  • "gaiaId"
  • "system"
authors[].gaiaId long Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов.
reviewers[] list Список пользователей, проверяющих предложение рабочей области.
reviewers[].type string Ими могут быть обычные пользователи или система Google Менеджера тегов.

Допустимые значения:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов.
history[] list История комментариев и изменений статуса.
history[].type string Возможны два типа записей в истории: комментарии и изменения статуса.

Допустимые значения:
  • "comment"
  • "statusChange"
  • "unspecified"
history[].comment nested object Комментарий автора или проверяющего.
history[].comment.content string Содержание комментария автора или проверяющего.
history[].statusChange nested object Изменение статуса предложения.
history[].statusChange.oldStatus string Статус предложения до его изменения.

Допустимые значения:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].statusChange.newStatus string Статус предложения после его изменения.

Допустимые значения:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].createdBy nested object Сторона, ответственная за изменение в истории.
history[].createdBy.type string Ею может быть обычный пользователь или система Google Менеджера тегов.

Допустимые значения:
  • "gaiaId"
  • "system"
history[].createdBy.gaiaId long Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов.
history[].createdTimestamp nested object Когда событие истории было добавлено в предложенную рабочую область.
history[].createdTimestamp.seconds long Время в формате Unix Timestamp. Допустимые значения: от 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z включительно.
history[].createdTimestamp.nanos integer Доля секунды в наносекундах. Свойство может принимать только неотрицательное целочисленное значение, даже если значение временной отметки в секундах является отрицательным. Возможные значения: от 0 до 999 999 999 включительно.
fingerprint string Цифровой отпечаток предложенной рабочей области, вычисленный во время хранения. Вычисляется заново при каждом изменении в предложении.

Практическое задание

Воспользуйтесь инструментом API Explorer, чтобы применить этот метод к реальным данным и узнать, как он работает.