Package google.ads.searchads360.v0.errors

Индекс

АутентификацияErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки аутентификации.

Ошибка аутентификации

Перечисление, описывающее возможные ошибки аутентификации.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
AUTHENTICATION_ERROR Аутентификация запроса не удалась.
CLIENT_CUSTOMER_ID_INVALID Идентификатор клиента клиента не является числом.
CUSTOMER_NOT_FOUND Клиент по указанному идентификатору клиента не найден.
GOOGLE_ACCOUNT_DELETED Аккаунт Google клиента удален.
GOOGLE_ACCOUNT_AUTHENTICATION_FAILED Возникла проблема при аутентификации аккаунта Google.
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH Пользователь в токене входа в учетную запись Google не соответствует идентификатору пользователя в файле cookie.
NOT_ADS_USER Аккаунт Google, сгенерировавший токен доступа OAuth, не связан с аккаунтом Search Ads 360. Создайте новую учетную запись или добавьте учетную запись Google к существующей учетной записи Search Ads 360.
OAUTH_TOKEN_INVALID Токен OAuth в заголовке недействителен.
OAUTH_TOKEN_EXPIRED Срок действия токена OAuth в заголовке истек.
OAUTH_TOKEN_DISABLED Токен OAuth в заголовке отключен.
OAUTH_TOKEN_REVOKED Токен OAuth в заголовке отозван.
OAUTH_TOKEN_HEADER_INVALID HTTP-заголовок токена OAuth имеет неверный формат.
USER_ID_INVALID Идентификатор пользователя в заголовке не является допустимым идентификатором.
TWO_STEP_VERIFICATION_NOT_ENROLLED Администратор учетной записи изменил настройки аутентификации этой учетной записи. Чтобы получить доступ к этой учетной записи, включите двухэтапную аутентификацию в своей учетной записи Google по адресу https://www.google.com/landing/2step .
ADVANCED_PROTECTION_NOT_ENROLLED Администратор учетной записи изменил настройки аутентификации этой учетной записи. Чтобы получить доступ к этой учетной записи, включите Дополнительную защиту в своей учетной записи Google по адресу https://landing.google.com/advancedprotection .

АвторизацияErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки авторизации.

Ошибка авторизации

Перечисление, описывающее возможные ошибки авторизации.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
USER_PERMISSION_DENIED У пользователя нет разрешения на доступ к клиенту. Примечание. Если вы обращаетесь к клиенту-клиенту, идентификатор клиента менеджера должен быть установлен в заголовке login-customer-id . Подробную информацию можно найти на странице https://developers.google.com/search-ads/reporting/concepts/call-structure#login_customer_id_header .
PROJECT_DISABLED Проект Google Cloud, отправленный в запросе, не имеет разрешения на доступ к API.
AUTHORIZATION_ERROR Авторизация клиента не удалась.
ACTION_NOT_PERMITTED У пользователя нет разрешения на выполнение этого действия (например, ДОБАВИТЬ, ОБНОВИТЬ, УДАЛИТЬ) над ресурсом или вызвать метод.
INCOMPLETE_SIGNUP Регистрация не завершена.
CUSTOMER_NOT_ENABLED Доступ к учетной записи клиента невозможен, поскольку она еще не активирована или деактивирована.
MISSING_TOS Разработчик должен подписать условия обслуживания. Их можно найти здесь: https://developers.google.com/terms.
INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION Указанный клиент для входа не имеет доступа к указанной учетной записи, поэтому запрос недействителен.
SERVICE_ACCESS_DENIED Указанный разработчик не имеет доступа к сервису.
ACCESS_DENIED_FOR_ACCOUNT_TYPE Клиенту (или клиенту, вошедшему в систему) запрещено использовать Search Ads 360 API. Он принадлежит другой рекламной системе.
METRIC_ACCESS_DENIED У разработчика нет доступа к запрошенным метрикам.

CustomColumnErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки настраиваемого столбца.

CustomColumnError

Перечисление, описывающее возможные ошибки специального столбца.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
CUSTOM_COLUMN_NOT_FOUND Пользовательский столбец не найден.
CUSTOM_COLUMN_NOT_AVAILABLE Пользовательский столбец недоступен.

Датеерроенум

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки даты.

ДатаОшибка

Перечисление, описывающее возможные ошибки даты.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
INVALID_FIELD_VALUES_IN_DATE Указанные значения полей не соответствуют действительной дате.
INVALID_FIELD_VALUES_IN_DATE_TIME Указанные значения полей не соответствуют допустимой дате и времени.
INVALID_STRING_DATE Формат даты строки должен быть гггг-мм-дд.
INVALID_STRING_DATE_TIME_MICROS Строковый формат даты и времени должен быть следующим: гггг-мм-дд чч:мм:сс.сссссс.
INVALID_STRING_DATE_TIME_SECONDS Строковый формат даты и времени должен быть следующим: гггг-мм-дд чч:мм:сс.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET Строковый формат даты и времени должен быть следующим: гггг-мм-дд чч:мм:сс+|-чч:мм.
EARLIER_THAN_MINIMUM_DATE Дата раньше допустимого минимума.
LATER_THAN_MAXIMUM_DATE Дата после разрешенного максимума.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Границы диапазона дат не в порядке.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Обе даты в диапазоне имеют значение null.

Датеранжеерроренум

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки диапазона дат.

ДатаРангеОррор

Перечисление, описывающее возможные ошибки диапазона дат.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
INVALID_DATE Недействительная дата.
START_DATE_AFTER_END_DATE Дата начала была позже даты окончания.
CANNOT_SET_DATE_TO_PAST Невозможно установить дату в прошедшее время
AFTER_MAXIMUM_ALLOWABLE_DATE Была использована дата, наступившая после «последней» даты системы.
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED Попытка изменить дату начала запущенного ресурса.

DistinctErrorEnum

Этот тип не имеет полей.

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

DistinctError

Перечисление, описывающее возможные отдельные ошибки.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
DUPLICATE_ELEMENT Дублирующийся элемент.
DUPLICATE_TYPE Дублирующийся тип.

Код ошибки

Причина ошибки представлена ​​типом и перечислением.

Поля
Поле объединения error_code . В списке ошибок error_code может быть только одно из следующих значений:
request_error

RequestError

Ошибка, вызванная запросом

query_error

QueryError

Ошибка с запросом

authorization_error

AuthorizationError

Произошла ошибка при попытке авторизации пользователя.

internal_error

InternalError

Непредвиденная ошибка на стороне сервера.

quota_error

QuotaError

Ошибка с размером оставшейся квоты.

authentication_error

AuthenticationError

Указывает на неспособность правильно аутентифицировать пользователя.

date_error

DateError

Причины ошибки даты

date_range_error

DateRangeError

Причины ошибки диапазона дат

distinct_error

DistinctError

Причины явной ошибки

header_error

HeaderError

Причины ошибки заголовка.

size_limit_error

SizeLimitError

Причины ошибки ограничения размера

custom_column_error

CustomColumnError

Причины ошибки специального столбца

invalid_parameter_error

InvalidParameterError

Причины ошибок недопустимых параметров.

Подробности об ошибке

Дополнительные сведения об ошибке.

Поля
unpublished_error_code

string

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

quota_error_details

QuotaErrorDetails

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

ОшибкаМестоположение

Описывает часть протокола запроса, вызвавшую ошибку.

Поля
field_path_elements[]

FieldPathElement

Путь к полю, указывающий, какое поле в запросе было недопустимым.

FieldPathElement

Часть полевой дороги.

Поля
field_name

string

Имя поля или одного из

index

int32

Если имя_поля является повторяющимся полем, это элемент, который не удалось выполнить.

ЗаголовокErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки заголовка.

Ошибка заголовка

Перечисление, описывающее возможные ошибки заголовка.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
INVALID_USER_SELECTED_CUSTOMER_ID Не удалось проверить выбранный пользователем идентификатор клиента.
INVALID_LOGIN_CUSTOMER_ID Не удалось подтвердить идентификатор клиента для входа.

Внутренняя ошибкаенум

Этот тип не имеет полей.

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

Внутренняя ошибка

Перечисление, описывающее возможные внутренние ошибки.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
INTERNAL_ERROR API обнаружил непредвиденную внутреннюю ошибку.
ERROR_CODE_NOT_PUBLISHED Предполагаемый код ошибки не существует в указанной версии API. Он будет выпущен в будущей версии API.
TRANSIENT_ERROR API обнаружил непредвиденную временную ошибку. В таких случаях пользователю следует повторить запрос.
DEADLINE_EXCEEDED Запрос занял больше времени, чем установленный срок.

Инвалидпараметеререренум

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки из-за недопустимого параметра.

Инвалидпараметреррор

Перечисление, описывающее возможные ошибки параметров.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
INVALID_CURRENCY_CODE Указанный код валюты недействителен.

QueryErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки запроса.

Ошибка запроса

Перечисление, описывающее возможные ошибки запроса.

Перечисления
UNSPECIFIED Имя не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
QUERY_ERROR Возвращается, если все остальные причины ошибки запроса неприменимы.
BAD_ENUM_CONSTANT Условие, используемое в запросе, ссылается на недопустимую константу перечисления.
BAD_ESCAPE_SEQUENCE Запрос содержит недопустимую escape-последовательность.
BAD_FIELD_NAME Имя поля недействительно.
BAD_LIMIT_VALUE Недопустимое предельное значение (например, не число)
BAD_NUMBER Встреченный номер не может быть разобран.
BAD_OPERATOR Обнаружен недопустимый оператор.
BAD_PARAMETER_NAME Параметр неизвестен или не поддерживается.
BAD_PARAMETER_VALUE Параметр имеет недопустимое значение.
BAD_RESOURCE_TYPE_IN_FROM_CLAUSE В предложении FROM указан недопустимый тип ресурса.
BAD_SYMBOL Символ, отличный от ASCII, встречающийся вне строк.
BAD_VALUE Недопустимое значение.
DATE_RANGE_TOO_WIDE Фильтры даты не могут ограничить дату диапазоном менее 31 дня. Применимо, если запрос сегментирован по дате.
DATE_RANGE_TOO_NARROW Фильтры по дате/неделе/месяцу/кварталу имеют дату начала после даты окончания.
EXPECTED_AND Ожидается И между значениями с оператором BETWEEN.
EXPECTED_BY Ожидается, что ORDER BY будет иметь BY.
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE Не было выбрано поле измерения.
EXPECTED_FILTERS_ON_DATE_RANGE Отсутствуют фильтры в полях, связанных с датой.
EXPECTED_FROM Отсутствует предложение FROM.
EXPECTED_LIST Оператор, используемый в условиях, требует, чтобы значение было списком.
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE Поля, используемые в предложениях WHERE или ORDER BY, отсутствуют в предложении SELECT.
EXPECTED_SELECT SELECT отсутствует в начале запроса.
EXPECTED_SINGLE_VALUE Список был передан как значение условия, оператор которого ожидает одно значение.
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR В операторе BETWEEN отсутствует одно или оба значения.
INVALID_DATE_FORMAT Неверный формат даты. Ожидается «ГГГГ-ММ-ДД».
MISALIGNED_DATE_FOR_FILTER Неверное значение даты для фильтра. Датой должно быть начало недели/месяца/квартала, если отфильтрованное поле имеет значение slots.week/segments.month/segments.quarter.
INVALID_STRING_VALUE Переданное значение не было строкой, хотя должно было быть. Например, это было число или литерал без кавычек.
INVALID_VALUE_WITH_BETWEEN_OPERATOR Строковое значение, переданное оператору BETWEEN, не анализируется как дата.
INVALID_VALUE_WITH_DURING_OPERATOR Значение, переданное оператору DURING, не является литералом диапазона дат.
INVALID_VALUE_WITH_LIKE_OPERATOR Значение было передано оператору LIKE.
OPERATOR_FIELD_MISMATCH Предоставлен оператор, неприменимый к фильтруемому полю.
PROHIBITED_EMPTY_LIST_IN_CONDITION Было найдено условие с пустым списком.
PROHIBITED_ENUM_CONSTANT Условие, используемое в запросе, ссылается на неподдерживаемую константу перечисления.
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Поля, которые нельзя выбирать вместе, были включены в предложение SELECT.
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE Поле, которое нельзя упорядочить, было включено в предложение ORDER BY.
PROHIBITED_FIELD_IN_SELECT_CLAUSE Поле, которое нельзя выбрать, было включено в предложение SELECT.
PROHIBITED_FIELD_IN_WHERE_CLAUSE Поле, которое нельзя фильтровать, было включено в предложение WHERE.
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE Тип ресурса, указанный в предложении FROM, не поддерживается этой службой.
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE Поле, полученное из несовместимого ресурса, было включено в предложение SELECT.
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE Поле, полученное из несовместимого ресурса, было включено в предложение WHERE.
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE В предложение SELECT или WHERE была включена метрика, несовместимая с основным ресурсом или другими выбранными ресурсами сегментации.
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE Сегмент, несовместимый с основным ресурсом или другими выбранными ресурсами сегментации, был включен в предложение SELECT или WHERE.
PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE Сегмент в предложении SELECT несовместим с метрикой в ​​предложении SELECT или WHERE.
LIMIT_VALUE_TOO_LOW Значение, переданное в предложение ограничения, слишком мало.
PROHIBITED_NEWLINE_IN_STRING В запросе есть строка, содержащая символ новой строки.
PROHIBITED_VALUE_COMBINATION_IN_LIST Список содержит значения разных типов.
PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR Значения, передаваемые оператору BETWEEN, не относятся к одному и тому же типу.
STRING_NOT_TERMINATED Запрос содержит незавершенную строку.
TOO_MANY_SEGMENTS В предложении SELECT указано слишком много сегментов.
UNEXPECTED_END_OF_QUERY Запрос неполный и не может быть проанализирован.
UNEXPECTED_FROM_CLAUSE Предложение FROM не может быть указано в этом запросе.
UNRECOGNIZED_FIELD Запрос содержит одно или несколько нераспознанных полей.
UNEXPECTED_INPUT В запросе есть неожиданная дополнительная часть.
REQUESTED_METRICS_FOR_MANAGER Метрики нельзя запросить для управляющего аккаунта. Чтобы получить метрики, отправьте отдельные запросы для каждого клиентского аккаунта в управляющем аккаунте.
FILTER_HAS_TOO_MANY_VALUES Количество значений (правых операндов) в фильтре превышает ограничение.

QuotaErrorПодробности

Дополнительные сведения об ошибке квоты при наличии QuotaError.

Поля
rate_scope

QuotaRateScope

Диапазон ставок лимита квоты.

rate_name

string

Высокоуровневое описание сегмента квот. Примеры: «Получить запросы на стандартный доступ» или «Запросы для каждой учетной записи».

retry_delay

Duration

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

QuotaRateScope

Перечисление возможных областей, которым принадлежат сегменты квот.

Перечисления
UNSPECIFIED Неуказанное перечисление
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ACCOUNT Квота на счет клиента
DEVELOPER По квоте проекта

QuotaErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки квоты.

Ошибка квоты

Перечисление, описывающее возможные ошибки квоты.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
RESOURCE_EXHAUSTED Слишком много запросов.
RESOURCE_TEMPORARILY_EXHAUSTED Слишком много запросов за короткий промежуток времени.

ЗапросErrorEnum

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки запроса.

Ошибка запроса

Перечисление, описывающее возможные ошибки запроса.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
RESOURCE_NAME_MISSING Для этого запроса необходимо имя ресурса.
RESOURCE_NAME_MALFORMED Указанное имя ресурса имеет неверный формат.
BAD_RESOURCE_ID Указанное имя ресурса имеет неверный формат.
INVALID_PRODUCT_NAME Название продукта недействительно.
INVALID_CUSTOMER_ID Идентификатор клиента недействителен.
OPERATION_REQUIRED Для операции изменения должно быть указано создание, обновление или удаление.
RESOURCE_NOT_FOUND Запрошенный ресурс не найден.
INVALID_PAGE_TOKEN Токен следующей страницы, указанный в запросе пользователя, недействителен.
EXPIRED_PAGE_TOKEN Срок действия токена следующей страницы, указанного в запросе пользователя, истек.
INVALID_PAGE_SIZE Размер страницы, указанный в запросе пользователя, недействителен.
REQUIRED_FIELD_MISSING Обязательное поле отсутствует.
IMMUTABLE_FIELD Поле нельзя изменить, поскольку оно неизменяемо. Также возможно, что поле можно изменить с помощью операции «создать», но не «обновить».
TOO_MANY_MUTATE_OPERATIONS Получено слишком много записей в запросе.
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT Запрос не может быть выполнен с помощью управляющего аккаунта.
CANNOT_MODIFY_FOREIGN_FIELD Запрос на изменение пытался изменить поле, доступное только для чтения. Например, поля бюджета можно запросить для группы объявлений, но они доступны только для чтения для adGroups:mutate.
INVALID_ENUM_VALUE Значение перечисления недопустимо.
LOGIN_CUSTOMER_ID_PARAMETER_MISSING Для этого запроса необходим параметр login-customer-id.
LOGIN_OR_LINKED_CUSTOMER_ID_PARAMETER_REQUIRED Для этого запроса требуется параметр login-customer-id или linked-customer-id.
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN page_token устанавливается в запросе только на проверку
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS return_summary_row нельзя включить, если запрос не выбрал ни одного поля показателя.
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS return_summary_row не следует включать только для запросов на проверку.
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE Значение параметра return_summary_row должно быть одинаковым для запросов с установленным полем page_token и их исходным запросом.
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED Общее количество результатов не может быть возвращено, если оно не было запрошено в исходном запросе.
RPC_DEADLINE_TOO_SHORT Срок, указанный клиентом, был слишком коротким.
PRODUCT_NOT_SUPPORTED Продукт, связанный с запросом, не поддерживается для текущего запроса.

Ошибка SearchAds360

Ошибка, связанная с Поисковой рекламой 360.

Поля
error_code

ErrorCode

Значение перечисления, указывающее, какая ошибка произошла.

message

string

Удобочитаемое описание ошибки.

trigger

Value

Значение, вызвавшее ошибку.

location

ErrorLocation

Описывает часть протокола запроса, вызвавшую ошибку.

details

ErrorDetails

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

Ошибка SearchAds360

Описывает, как произошел сбой при вызове API Search Ads 360. Он возвращается внутри google.rpc.Status.details при сбое вызова.

Поля
errors[]

SearchAds360Error

Список произошедших ошибок.

request_id

string

Уникальный идентификатор запроса, который используется в целях отладки.

Размерелимитерерренум

Этот тип не имеет полей.

Контейнер для перечисления, описывающего возможные ошибки ограничения размера.

Размерелимитеррор

Перечисление, описывающее возможные ошибки ограничения размера.

Перечисления
UNSPECIFIED Перечисление не указано.
UNKNOWN Полученный код ошибки в этой версии неизвестен.
REQUEST_SIZE_LIMIT_EXCEEDED Количество записей в запросе превышает системный лимит или содержимое операций превышает лимиты транзакций из-за их размера или сложности. Попробуйте уменьшить количество записей на запрос.
RESPONSE_SIZE_LIMIT_EXCEEDED Количество записей в ответе превышает системный лимит.