Errores de la API Indexing

En este documento se indican algunos de los códigos y mensajes de error que devuelven las APIs de Google; concretamente, se incluyen los que se producen en el dominio global (o predeterminado). Muchas APIs también tienen sus propios dominios, que identifican los errores que son específicos de esas APIs y no ocurren en el dominio global. Cuando se producen este tipo de errores, en la propiedad domain del documento JSON de respuesta aparece un valor específico de la API en cuestión, como youtube.parameter.

En esta página, los errores se identifican con códigos de estado HTTP, tal como están definidos en RFC 7231.

A continuación se incluye un ejemplo de respuesta JSON que muestra cómo se comunica un error global:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

Errores

MOVED_PERMANENTLY (301)

Código de error	Descripción
`movedPermanently`	Tanto la solicitud que ha devuelto este error como las que se hagan a partir de ahora para que se lleve a cabo esta operación tienen que enviarse a la URL que se indica en el encabezado `Location` de esta respuesta, no a la URL a la que se envió la solicitud.

SEE_OTHER (303)

Código de error	Descripción
`seeOther`	La solicitud se ha procesado correctamente. Para obtener la respuesta, envía una solicitud `GET` a la URL que se indica en el encabezado `Location`.
`mediaDownloadRedirect`	La solicitud se ha procesado correctamente. Para obtener la respuesta, envía una solicitud `GET` a la URL que se indica en el encabezado `Location`.

NOT_MODIFIED (304)

Código de error	Descripción
`notModified`	No se ha cumplido la condición definida en un encabezado If-None-Match. Esta respuesta indica que el documento solicitado no se ha modificado y que debe cargarse una respuesta almacenada en caché. Comprueba el valor del encabezado `If-None-Match` de la solicitud HTTP.

TEMPORARY_REDIRECT (307)

Código de error	Descripción
`temporaryRedirect`	Para que se procese la solicitud, tienes que reenviarla a la URL que se indica en el encabezado `Location` de esta respuesta.

BAD_REQUEST (400)

Código de error	Descripción
`badRequest`	La solicitud a la API no es válida o su formato no es correcto, por lo que el servidor de la API no la ha podido entender.
`badBinaryDomainRequest`	La solicitud de dominio binario no es válida.
`badContent`	Los datos de la solicitud o una parte de una solicitud con varias partes son de un tipo de contenido que no se admite.
`badLockedDomainRequest`	La solicitud de dominio bloqueado no es válida.
`corsRequestWithXOrigin`	La solicitud CORS incluye un encabezado XD3 X‑Origin, por lo que no es correcta.
`endpointConstraintMismatch`	Se ha producido un error en la solicitud porque no coincide con la API especificada. Comprueba que la ruta de URL sea correcta.
`invalid`	Se ha producido un error en la solicitud porque contenía un valor no válido. Este valor puede ser el de un parámetro, un encabezado o una propiedad.
`invalidAltValue`	El valor del parámetro `alt` indica un formato de salida desconocido.
`invalidHeader`	Se ha producido un error en la solicitud porque contenía un encabezado no válido.
`invalidParameter`	Se ha producido un error en la solicitud porque contenía un parámetro o un valor de parámetro no válidos. Consulta la documentación de la API para saber qué parámetros pueden incluirse en las solicitudes.
`invalidQuery`	La solicitud no es válida. Consulta la documentación de la API para saber qué parámetros pueden incluirse en la solicitud y determinar si contenía parámetros incompatibles entre ellos o valores de parámetro no válidos. Comprueba el valor del parámetro `q` de la solicitud.
`keyExpired`	La clave de API que figura en la solicitud ha caducado, por lo que el servidor de la API no puede comprobar si la aplicación que ha hecho la solicitud ha alcanzado el límite de cuota. Puedes consultar más información o conseguir otra clave en Google Developers Console.
`keyInvalid`	La clave de API que figura en la solicitud no es válida, por lo que el servidor de la API no puede comprobar si la aplicación que ha hecho la solicitud ha alcanzado el límite de cuota. Encuentra tu clave de API o consigue una en Google Developers Console.
`lockedDomainCreationFailure`	El token de OAuth se ha recibido en la cadena de consulta, una práctica que esta API prohíbe en todos los formatos que no sean JSON o XML; si es posible, prueba a enviar el token de OAuth incluido en el encabezado Authorization.
`notDownload`	A las rutas de URL que incluyen `/download/*` solo se pueden enviar solicitudes para descargar elementos multimedia. Vuelve a enviar la solicitud a la misma ruta, pero quítale el prefijo `/download`.
`notUpload`	No se ha podido realizar la solicitud porque no es de subida, que son las únicas que se pueden enviar a URI que incluyen `/upload/*`. Prueba a enviar de nuevo la solicitud a la misma ruta, pero esta vez sin el prefijo `/upload`.
`parseError`	El servidor de la API no ha podido analizar el cuerpo de la solicitud.
`required`	En la solicitud a la API faltan datos obligatorios, como un parámetro o una propiedad de recurso.
`tooManyParts`	Se ha producido un error en la solicitud porque contiene demasiadas partes.
`unknownApi`	No se reconoce la API a la que llama la solicitud.
`unsupportedMediaProtocol`	El cliente está utilizando un protocolo de elementos multimedia que no se admite.
`unsupportedOutputFormat`	El valor del parámetro `alt` indica un formato de salida que no es compatible con este servicio. Comprueba el valor del parámetro `alt` de la solicitud.
`wrongUrlForUpload`	No se ha podido realizar la solicitud, aun siendo de subida, porque no se ha enviado al URI adecuado. Este tipo de solicitudes deben enviarse a URI que incluyan el prefijo `/upload/*`. Prueba a enviar de nuevo la solicitud a la misma ruta, pero con el prefijo `/upload`.

UNAUTHORIZED (401)

Código de error	Descripción
`unauthorized`	El usuario no está autorizado a hacer la solicitud.
`authError`	Las credenciales de autorización que se han proporcionado en la solicitud no son válidas. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`expired`	La sesión ha caducado. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`lockedDomainExpired`	No se ha podido realizar la solicitud porque ha caducado un dominio bloqueado que antes era válido.
`required`	El usuario debe iniciar sesión para enviar esta solicitud a la API. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.

PAYMENT_REQUIRED (402)

Código de error	Descripción
`dailyLimitExceeded402`	Se ha alcanzado el límite de presupuesto diario definido por el desarrollador.
`quotaExceeded402`	Para completar la operación solicitada, se necesitan más recursos de los que permite la cuota, por lo que hay que hacer un pago.
`user402`	Para completar la operación solicitada, el usuario autenticado debe hacer algún tipo de pago.

FORBIDDEN (403)

Código de error	Descripción
`forbidden`	La operación que se ha solicitado está prohibida y no se puede completar.
`accessNotConfigured`	Tu proyecto no está configurado para acceder a esta API. Activa la API en tu proyecto con Google Developers Console.
`accessNotConfigured`	El proyecto se ha bloqueado debido a un uso inadecuado. Consulta el recurso http://support.google.com/code/go/developer_compliance.
`accessNotConfigured`	El proyecto se ha marcado para eliminarlo.
`accountDeleted`	Se ha eliminado la cuenta de usuario asociada a las credenciales de autorización de la solicitud. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`accountDisabled`	Se ha inhabilitado la cuenta de usuario asociada a las credenciales de autorización de la solicitud. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`accountUnverified`	La dirección de correo electrónico del usuario que ha hecho la solicitud no está verificada. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`concurrentLimitExceeded`	Se ha producido un error en la solicitud porque se ha alcanzado el límite de uso.
`dailyLimitExceeded`	Se ha alcanzado el límite de cuota diaria de la API.
`dailyLimitExceeded`	Se ha alcanzado el límite de cuota diaria y se ha bloqueado el proyecto debido a un uso inadecuado. Para recibir ayuda con el problema, consulta el formulario de asistencia de cumplimiento de las API de Google.
`dailyLimitExceededUnreg`	Se ha producido un error en la solicitud porque se ha alcanzado el límite diario de usos no autenticados de la API. Para seguir utilizándola, hay que registrarse en Google Developers Console.
`downloadServiceForbidden`	La API no admite un servicio de descarga.
`insufficientAudience`	La solicitud no se puede completar para esta audiencia.
`insufficientAuthorizedParty`	La solicitud no se puede completar para esta aplicación.
`insufficientPermissions`	El usuario autenticado no tiene permisos suficientes para ejecutar esta solicitud.
`limitExceeded`	No se puede completar la solicitud debido a límites de acceso o de frecuencia.
`lockedDomainForbidden`	Esta API no admite dominios bloqueados.
`quotaExceeded`	Para completar la operación, se necesitan más recursos de los que permite la cuota.
`rateLimitExceeded`	Se han enviado demasiadas solicitudes en un periodo determinado.
`rateLimitExceededUnreg`	Se ha superado el límite de frecuencia, por lo que debes registrar tu aplicación para seguir llamando a la API. Regístrate en Google Developers Console.
`responseTooLarge`	El recurso solicitado es demasiado grande como para devolverse.
`servingLimitExceeded`	Ya se ha alcanzado el límite de frecuencia general que se ha especificado en la API.
`sslRequired`	Debe usarse SSL para completar esta operación.
`unknownAuth`	El servidor de la API no reconoce el esquema de autorización empleado en la solicitud. Comprueba el valor del encabezado `Authorization` de la solicitud HTTP.
`userRateLimitExceeded`	Se ha producido un error en la solicitud porque se ha alcanzado el límite de frecuencia por usuario.
`userRateLimitExceededUnreg`	Se ha producido un error en la solicitud porque se ha alcanzado el límite de frecuencia por usuario y no se ha identificado el desarrollador del cliente en la solicitud. Crea un proyecto para tu aplicación en Google Developers Console (https://console.developers.google.com).
`variableTermExpiredDailyExceeded`	Se ha producido un error en la solicitud porque ha caducado la cuota de periodo variable y se ha alcanzado el límite diario.
`variableTermLimitExceeded`	Se ha producido un error en la solicitud porque se ha alcanzado el límite de la cuota de periodo variable.

NOT_FOUND (404)

Código de error	Descripción
`notFound`	No se ha podido completar la operación solicitada porque no se ha podido encontrar un recurso asociado a la solicitud.
`notFound`	No se ha podido encontrar un recurso asociado a la solicitud. Si no has utilizado esta API en las dos últimas semanas, vuelve a implementar la aplicación de App Engine y prueba a llamarla de nuevo.
`unsupportedProtocol`	No se admite el protocolo que se utiliza en la solicitud.

METHOD_NOT_ALLOWED (405)

Código de error	Descripción
`httpMethodNotAllowed`	No se admite el método HTTP asociado a la solicitud.

CONFLICT (409)

Código de error	Descripción
`conflict`	No se puede completar la solicitud a la API porque la operación que se solicita entraría en conflicto con un elemento. Por ejemplo, se crearía un conflicto si una solicitud intenta duplicar un elemento, aunque este tipo de errores se identifican de un modo más específico.
`duplicate`	No se ha podido completar la operación porque se ha intentado crear un recurso que ya existe.

GONE (410)

Código de error	Descripción
`deleted`	Se ha producido un error en la solicitud porque se ha eliminado el recurso asociado a ella.

PRECONDITION_FAILED (412)

Código de error	Descripción
`conditionNotMet`	No se ha cumplido la condición definida en el encabezado `If-Match` o `If-None-Match` de la solicitud HTTP. Consulta más información en el apartado ETag de la especificación HTTP. Comprueba el valor del encabezado `If-Match` de la solicitud HTTP.

REQUEST_ENTITY_TOO_LARGE (413)

Código de error	Descripción
`backendRequestTooLarge`	La solicitud es demasiado grande.
`batchSizeTooLarge`	La solicitud por lotes contiene demasiados elementos.
`uploadTooLarge`	Se ha producido un error en la solicitud porque los datos incluidos en ella son demasiado grandes.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

Código de error	Descripción
`requestedRangeNotSatisfiable`	En la solicitud se indicaba un rango que no puede cumplirse.

EXPECTATION_FAILED (417)

Código de error	Descripción
`expectationFailed`	El servidor no puede cumplir una expectativa del cliente.

PRECONDITION_REQUIRED (428)

Código de error	Descripción
`preconditionRequired`	Para que la solicitud se complete correctamente, debe cumplirse una condición previa que no está indicada. Debes proporcionar un encabezado `If-Match` o `If-None-Match` junto con la solicitud.

TOO_MANY_REQUESTS (429)

Código de error	Descripción
`rateLimitExceeded`	Se han enviado demasiadas solicitudes en un periodo determinado.

INTERNAL_SERVER_ERROR (500)

Código de error	Descripción
`internalError`	No se ha podido realizar la solicitud debido a un error interno.

NOT_IMPLEMENTED (501)

Código de error	Descripción
`notImplemented`	No se ha implementado la operación solicitada.
`unsupportedMethod`	Se ha producido un error en la solicitud porque está intentando ejecutar un método o una operación desconocidos.

SERVICE_UNAVAILABLE (503)

Código de error	Descripción
`backendError`	Se ha producido un error del servidor.
`backendNotConnected`	No se ha podido completar la solicitud debido a un error de conexión.
`notReady`	El servidor de la API no está listo para aceptar solicitudes.

Errores específicos de la API Indexing

Si se devuelve alguno de los mensajes de error principales o de los indicados a continuación, entonces se ha rechazado la solicitud enviada, por lo que Google no rastreará la URL.

BAD_REQUEST (400)

Mensaje de error	Descripción
`Missing attribute. 'url' attribute is required.`	El usuario no ha incluido ninguna URL en su solicitud.
`Invalid attribute. 'url' is not in standard URL format`	El usuario ha incluido una URL que no se parece a una URL; por ejemplo, "abcd".
`Unknown type. 'type' attribute is required and must be 'URL_REMOVED' or 'URL_UPDATED'.`	El usuario no ha configurado el tipo de notificación.
`Invalid value at 'url_notification.type' (TYPE_ENUM)`	El usuario no ha asignado los valores `URL_REMOVED` o `URL_UPDATED` al tipo de notificación.

FORBIDDEN (403)

Mensaje de error	Descripción
`Permission denied. Failed to verify the URL ownership.`	El usuario no ha completado el proceso de verificación de propiedad, o bien está intentando actualizar una URL que no le pertenece.

TOO_MANY_REQUESTS (429)

Mensaje de error	Descripción
`Insufficient tokens for quota 'indexing.googleapis.com/default_requests'`	El usuario ha superado la cuota permitida en la API Indexing.