Создает предложение рабочей области для 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 Менеджера тегов.
Допустимые значения:
|
|
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 |
Статус предложения в процессе рассмотрения.
Допустимые значения:
|
|
authors[] |
list |
Список авторов предложенной рабочей области. | |
authors[].type |
string |
Ими могут быть обычные пользователи или система Google Менеджера тегов.
Допустимые значения:
|
|
authors[].gaiaId |
long |
Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов. | |
reviewers[] |
list |
Список пользователей, проверяющих предложение рабочей области. | |
reviewers[].type |
string |
Ими могут быть обычные пользователи или система Google Менеджера тегов.
Допустимые значения:
|
|
reviewers[].gaiaId |
long |
Идентификатор GAIA, связанный с пользователем, которого нет в системе Google Менеджера тегов. | |
history[] |
list |
История комментариев и изменений статуса. | |
history[].type |
string |
Возможны два типа записей в истории: комментарии и изменения статуса.
Допустимые значения:
|
|
history[].comment |
nested object |
Комментарий автора или проверяющего. | |
history[].comment.content |
string |
Содержание комментария автора или проверяющего. | |
history[].statusChange |
nested object |
Изменение статуса предложения. | |
history[].statusChange.oldStatus |
string |
Статус предложения до его изменения.
Допустимые значения:
|
|
history[].statusChange.newStatus |
string |
Статус предложения после его изменения.
Допустимые значения:
|
|
history[].createdBy |
nested object |
Сторона, ответственная за изменение в истории. | |
history[].createdBy.type |
string |
Ею может быть обычный пользователь или система Google Менеджера тегов.
Допустимые значения:
|
|
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, чтобы применить этот метод к реальным данным и узнать, как он работает.