Apéndices de referencia de la API de XML

Operadores booleanos

Puedes utilizar operadores booleanos en los valores de los siguientes parámetros:

Definiciones de operadores booleanos

Nota: No puedes incluir espacios en los valores de los parámetros.

Booleano Y [.]
Descripción

El operador AND (.) muestra resultados que se encuentran en la intersección de las colecciones a ambos lados del operador “.”.

Ejemplos

En este ejemplo, se quitan todos los resultados que están en francés o italiano:
lr=(-lang_fr).(-lang_it)


Booleano NO [-]
Descripción

El operador NOT (.) quita todos los resultados que están en la colección inmediatamente después del operador menos ("-").

Ejemplos

En este ejemplo, se quitan todos los resultados que están en francés:
lr=-lang_fr

En este ejemplo, se quitan todos los resultados que están en francés o italiano:
lr=(-lang_fr).(-lang_it)

Nota: Quizás hayas notado que el segundo ejemplo anterior usa el operador booleano Y para especificar que los resultados no deben escribirse en francés ni italiano. Según la ubicación de los paréntesis en tu consulta, puedes usar el operador Booleano AND o el operador boolean OR para expresar esta consulta. Esto se debe a que, si un documento está escrito en francés, no está escrito en italiano. Por lo tanto, la declaración booleana debe expresar que el documento no está escrito en francés y que no está escrito en italiano.


Booleano O [|]
Descripción

El operador OR (.) muestra los resultados que se encuentran en la colección a la izquierda o a la derecha del operador de canalización (“|”).

Ejemplos

En este ejemplo, se muestran todos los resultados escritos en chino simplificado o tradicional:
lr=lang_zh-TW|lang_zh-CN

En este ejemplo, se solicitan todos los resultados que no están escritos en francés ni italiano. Ten en cuenta que coloca paréntesis en una ubicación diferente a la de la consulta de muestra para el operador Boolean AND:
lr=-(lang_fr|lang_it)


Paréntesis booleanos [()]
Descripción

Este operador te permite asegurarte de que se evalúen todos los términos del conjunto más interno de paréntesis antes de que se evalúen los que están fuera de los paréntesis. Puedes usar paréntesis para ajustar el orden en el que se evalúan los términos.

Ejemplos

En el ejemplo del operador NOT [-], se muestra la siguiente construcción para los resultados de solicitudes que no están escritos en francés ni italiano:
lr=(-lang_fr).(-lang_it)

En el ejemplo del operador OR (|), también se muestra una solicitud de resultados que no están escritos en francés o italiano. Dado que en el último ejemplo se usa el operador OR en lugar del operador AND, también debe cambiar la ubicación del paréntesis:
lr=-(lang_fr|lang_it)


Escapada de URL

Para realizar una solicitud de búsqueda HTTP, debes seguir ciertas convenciones para que Google pueda traducirla correctamente y generar una respuesta apropiada.

El esquema de URL HTTP especifica que una solicitud de URL HTTP solo puede contener ciertos caracteres:

  • Caracteres alfanuméricos: (a-z, A-Z, 0-9)
  • Caracteres especiales: $ - _ . | + ! * ' ( )
  • Caracteres reservados: ; / ? : @ = &

Google usa caracteres reservados para decodificar las URLs y utiliza algunos caracteres especiales para solicitar funciones de búsqueda. En consecuencia, debes escapar de la URL todos los caracteres que no sean alfanuméricos que aparezcan en los valores de los parámetros de búsqueda.

Para usar una URL como escape de una cadena, convierte cada secuencia de caracteres de espacio en blanco en un solo signo "+" (signo más) y reemplaza los demás caracteres no alfanuméricos por la codificación hexadecimal que representa el valor de ese carácter. En la siguiente tabla, se muestran las codificaciones hexadecimales para los caracteres especiales y reservados que se mencionaron antes. Cada uno de estos caracteres debe tener escape de URL en los valores de los parámetros de solicitud.

Carácter Codificación
hexadecimal
$ %24
- %2D
_ %5F
. %2E
+ %2,000 M
! %21
* %2A
" %22
' %27
( %28
) %29
; %3,000 millones
/ %2F
? %3F
: %3A
@ %40
= %3D
y %26
| %7C

Ejemplos

Cadena original String con escape de URL
golpear&juda golpe%26judy
O'Reilly O%27Reilly

Puedes encontrar más información sobre el escape de URLs en los sitios web del W3C y del IETF.

Comprime los resultados

Google puede comprimir los resultados de la búsqueda con la compresión HTTP gzip. Si puedes descomprimir contenido comprimido con el algoritmo gzip, puedes ahorrar entre un 50% y un 70% de ancho de banda, lo que puede mejorar tus tiempos de respuesta.

Para solicitar que Google muestre resultados en formato comprimido, agrega el encabezado HTTP Accept-Encoding a tu solicitud de búsqueda HTTP de la siguiente manera:

Accept-Encoding: gzip

Si Google muestra los resultados de la búsqueda mediante la compresión gzip, entonces incluimos la siguiente línea en los encabezados HTTP que se muestran:

Codificación de contenido: gzip

Nota: Si el encabezado HTTP Content-Encoding no está presente en la respuesta como se muestra arriba, Google no comprimió los resultados.

Este comportamiento se especifica en el estándar HTTP. Consulta ese documento para obtener información adicional sobre el uso de la compresión HTTP gzip.

Valores internacionales

Esquemas de codificación de caracteres

En la siguiente tabla, se indican los esquemas de codificación de caracteres que admite Google. Puedes asignar a los parámetros ie y oe los valores de cualquiera de las dos primeras columnas de esta tabla. Los valores de la primera columna son sobrenombres para los esquemas de codificación; los valores de la segunda columna son los nombres estándar de los esquemas de codificación. Google muestra los nombres estándar en los resultados XML, y los nombres estándar son adecuados para su uso en los encabezados HTTP Content-type de tu documento.

Nombre de Google Codificación Idiomas admitidos asociados
latin1 ISO-8859-1 Europa occidental (alemán, catalán, danés, español, finés, francés, holandés, inglés, indonesio, italiano, noruego, portugués, sueco)
latin2 ISO-8859-2 Europeo oriental (croata, checo, húngaro, , rumano, serbio, eslovaco, esloveno)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Báltico (estonio, letón, lituano)
cirílico ISO-8859-5 Búlgaro, ruso
arabic ISO-8859-6  
griego/griega ISO-8859-7 Griego
hebrew ISO-8859-8 Hebreo
latin5 ISO-8859-9  
latin6 ISO-8859-10 Islandés
euc-jp EUC-JP Japonés
euc-kr EUC-KR Coreano
Sji Shift_JIS Japonés
big5 Big5 Chino tradicional
gb GB2312 Chino simplificado
utf8 UTF-8 All

Idiomas de interfaz compatibles

Google admite 74 idiomas. El idioma de interfaz predeterminado es inglés. En la siguiente lista, se identifican todos los idiomas de interfaz que Google admite.

Idioma de visualización Valor del parámetro hl
Afrikáans af
Albanés sq
Amhár am
Árabe ar
Armenio hy
Azerí az
Bengalí bn
Búlgaro bg
Birmano my
Catalán ca
Chino (simplificado) zh-CN
Chino (tradicional) zh-TW
Croata h
Checo cs
Danés da
Neerlandés nl
Inglés (Reino Unido) en-GB
Inglés en
Estonio et
Filipino fil
Finlandés fi
Francés (canadiense) fr-CA
Francés fr
Georgiano ka
Alemán de
Griego el
Guyaratí gu
Hebreo iw
Hindi hi
Húngaro hu
Islandés is
Indonesio id
Italiano it
Japonés ja
Canarés kn
Kazajo kk
Jemer km
Coreano ko
Kirguís ky
Laosiano lo
Letón lv
Lituano lt
Macedonio mk
Malayo ms
Malayam ml
Maratí mr
Mongol mn
Nepalí ne
Noruego (Bokmal) no
Persa fa
Polaco pl
Portugués (Brasil) pt-BR
Portugués (Portugal) pt-PT
Panyabí pa
Rumano ro
Ruso ru
Serbio (latino) sr-Latn
Serbio sr
Cingalés si
Eslov sk
Esloveno sl
Español (Latinoamérica) es-419
Español es
Suajili sw
Sueco sv
Tamil ta
Telugu te
Tailandés th
Turco tr
Ucraniano uk
Urdu ur
Uzbeko uz
Vietnamita vi
Galés cy

Valores de la recopilación de idiomas

Puedes usar los siguientes valores para especificar un filtro de idioma mediante el parámetro de consulta lr:

Idioma Valor del parámetro lr
Árabe lang_ar
Búlgaro lang_bg
Catalán lang_ca
Chino (simplificado) lang_zh-CN
Chino (tradicional) lang_zh-TW
Croata lang_hr
Checo lang_cs
Danés lang_da
Neerlandés lang_nl
Inglés lang_en
Estonio lang_et
Finlandés lang_fi
Francés lang_fr
Alemán lang_de
Griego lang_el
Hebreo lang_iw
Húngaro lang_hu
Islandés lang_is
Indonesio lang_id
Italiano lang_it
Japonés lang_ja
Coreano lang_ko
Letón lang_lv
Lituano lang_lt
Noruego lang_no
Polaco lang_pl
Portugués lang_pt
Rumano lang_ro
Ruso lang_ru
Serbio lang_sr
Eslovaco lang_sk
Esloveno lang_sl
Español lang_es
Sueco lang_sv
Turco lang_tr

Valores de la recopilación de países

Puedes usar los siguientes valores para especificar un filtro de país mediante el parámetro de consulta cr:

País Nombre de la colección del país
Afganistán countryAF
Albania countryAL
Argelia countryDZ
Samoa Americana countryAS
Andorra countryAD
Angola countryAO
Anguila countryAI
Antártida countryAQ
Antigua y Barbuda countryAG
Argentina countryAR
Armenia countryAM
Aruba countryAW
Australia countryAU
Austria countryAT
Azerbaiyán countryAZ
Bahamas countryBS
Baréin countryBH
Bangladés countryBD
Barbados countryBB
Bielorrusia countryBY
Bélgica countryBE
Belice countryBZ
Benín countryBJ
Bermudas countryBM
Bután countryBT
Bolivia countryBO
Bosnia-Herzegovina countryBA
Botsuana countryBW
Isla Bouvet countryBV
Brasil countryBR
Territorio Británico del Océano Índico countryIO
Brunéi Darussalam countryBN
Bulgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Camboya countryKH
Camerún countryCM
Canadá countryCA
Cabo Verde countryCV
Islas Caimán countryKY
República Centroafricana countryCF
Chad countryTD
Chile countryCL
China countryCN
Isla de Navidad countryCX
Islas Cocos (Keeling) countryCC
Colombia countryCO
Comoras countryKM
Congo countryCG
República Democrática del Congo countryCD
Islas Cook countryCK
Costa Rica countryCR
Costa de Marfil countryCI
Croacia (Hrvatska) countryHR
Cuba countryCU
Chipre countryCY
República Checa countryCZ
Dinamarca countryDK
Yibuti countryDJ
Dominica countryDM
República Dominicana countryDO
Timor Oriental countryTP
Ecuador countryEC
Egipto countryEG
El Salvador countrySV
Guinea Ecuatorial countryGQ
Eritrea countryER
Estonia countryEE
Etiopía countryET
Unión Europea countryEU
Islas Malvinas countryFK
Islas Feroe countryFO
Fiyi countryFJ
Finlandia countryFI
Francia countryFR
Francia, metrópolis countryFX
Guayana Francesa countryGF
Polinesia Francesa countryPF
Territorios Australes Franceses countryTF
Gabón countryGA
Gambia countryGM
Georgia countryGE
Alemania countryDE
Ghana countryGH
Gibraltar countryGI
Grecia countryGR
Groenlandia countryGL
Granada countryGD
Guadalupe countryGP
Guam countryGU
Guatemala countryGT
Guinea countryGN
Guinea-Bisáu countryGW
Guyana countryGY
Haití countryHT
Islas Heard y McDonald countryHM
Santa Sede (Estado de la Ciudad del Vaticano) countryVA
Honduras countryHN
Hong Kong countryHK
Hungría countryHU
Islandia countryIS
India countryIN
Indonesia countryID
Irán, República Islámica de countryIR
Irak countryIQ
Irlanda countryIE
Israel countryIL
Italia countryIT
Jamaica countryJM
Japón countryJP
Jordania countryJO
Kazajistán countryKZ
Kenia countryKE
Kiribati countryKI
Corea, República Democrática Popular de countryKP
República de Corea countryKR
Kuwait countryKW
Kirguistán countryKG
República Democrática Popular Lao countryLA
Letonia countryLV
Líbano countryLB
Lesoto countryLS
Liberia countryLR
Yamahiriya Árabe Libia countryLY
Liechtenstein countryLI
Lituania countryLT
Luxemburgo countryLU
Macao countryMO
Macedonia, Antigua República Yugosalva de countryMK
Madagascar countryMG
Malaui countryMW
Malasia countryMY
Maldivas countryMV
Malí countryML
Malta countryMT
Islas Marshall countryMH
Martinica countryMQ
Mauritania countryMR
Mauricio countryMU
Mayotte countryYT
México countryMX
Estados Federados de Micronesia countryFM
República de Moldavia countryMD
Mónaco countryMC
Mongolia countryMN
Montserrat countryMS
Marruecos countryMA
Mozambique countryMZ
Birmania countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNP
Países Bajos countryNL
Antillas Neerlandesas countryAN
Nueva Caledonia countryNC
Nueva Zelanda countryNZ
Nicaragua countryNI
Níger countryNE
Nigeria countryNG
Niue countryNU
Isla Norfolk countryNF
Islas Marianas del Norte countryMP
Noruega countryNO
Omán countryOM
Pakistán countryPK
Palaos countryPW
Territorio Palestino countryPS
Panamá countryPA
Papúa Nueva Guinea countryPG
Paraguay countryPY
Perú countryPE
Filipinas countryPH
Islas Pitcairn countryPN
Polonia countryPL
Portugal countryPT
Puerto Rico countryPR
Catar countryQA
Reunión countryRE
Rumania countryRO
Federación Rusa countryRU
Ruanda countryRW
Santa Elena countrySH
San Cristóbal y Nieves countryKN
Santa Lucía countryLC
San Pedro y Miquelón countryPM
San Vicente y las Granadinas countryVC
Samoa countryWS
San Marino countrySM
Santo Tomé y Príncipe countryST
Arabia Saudita countrySA
Senegal countrySN
Serbia y Montenegro countryCS
Seychelles countrySC
Sierra Leona countrySL
Singapur countrySG
Eslovaquia countrySK
Eslovenia countrySI
Islas Salomón countrySB
Somalia countrySO
Sudáfrica countryZA
Islas Georgias del Sur y Sandwich del Sur countryGS
España countryES
Sri Lanka countryLK
Sudán countrySD
Surinam countrySR
Svalbard y Jan Mayen countrySJ
Suazilandia countrySZ
Suecia countrySE
Suiza countryCH
República Árabe Siria countrySY
Taiwán, provincia de China countryTW
Tayikistán countryTJ
República Unida de Tanzania countryTZ
Tailandia countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad y Tobago countryTT
Túnez countryTN
Türkiye countryTR
Turkmenistán countryTM
Islas Turcas y Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucrania countryUA
Emiratos Árabes Unidos countryAE
Reino Unido countryUK
Estados Unidos countryUS
Islas Ultramarinas Menores de los Estados Unidos countryUM
Uruguay countryUY
Uzbekistán countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam countryVN
Islas Vírgenes Británicas countryVG
Islas Vírgenes, EE.UU. countryVI
Wallis y Futuna countryWF
Sahara Occidental countryEH
Yemen countryYE
Yugoslavia countryYU
Zambia countryZM
Zimbabue countryZW

Códigos de país

En la siguiente tabla, se indican los códigos de país de dos letras que se pueden usar como valores del parámetro gl:

País Country Code
Afganistán af
Albania al
Argelia dz
Samoa Americana como
Andorra anuncio
Angola ao
Anguila ai
Antártida AC
Antigua y Barbuda ag
Argentina ar
Armenia am
Aruba aw
Australia au
Austria at
Azerbaiyán az
Bahamas bs
Baréin bh
Bangladés bd
Barbados bb
Bielorrusia por
Bélgica be
Belice zz
Benín bj
Bermudas bm
Bután bt
Bolivia bo
Bosnia-Herzegovina ba
Botsuana bw
Isla Bouvet BV
Brasil al
Territorio Británico del Océano Índico io
Brunéi Darussalam bn
Bulgaria bg
Burkina Faso bf
Burundi bi
Camboya kh
Camerún cm
Canadá ca
Cabo Verde cv
Islas Caimán ky
República Centroafricana cf
Chad td
Chile cl
China cn
Isla de Navidad cx
Islas Cocos (Keeling) Cc
Colombia co
Comoras km
Congo CG
República Democrática del Congo cd
Islas Cook ck
Costa Rica cr
Costa de Marfil ci
Croacia h
Cuba cu
Chipre cy
República Checa cz
Dinamarca dk
Yibuti DJ
Dominica MD
República Dominicana do
Ecuador ec
Egipto eg
El Salvador sv
Guinea Ecuatorial gq
Eritrea er
Estonia ee
Etiopía et
Islas Malvinas juro
Islas Feroe fo
Fiyi fj
Finlandia fi
Francia fr
Guayana Francesa gf
Polinesia Francesa pf
Territorios Australes Franceses tf
Gabón ga
Gambia gm
Georgia ge
Alemania de
Ghana gh
Gibraltar GI
Grecia gr
Groenlandia gl
Granada gd
Guadalupe gp
Guam gu
Guatemala gt
Guinea gn
Guinea-Bisáu gw
Guyana gyh
Haití ht
Islas Heard y McDonald Mm
Santa Sede (Estado de la Ciudad del Vaticano) va
Honduras hn
Hong Kong hk
Hungría hu
Islandia es
India en
Indonesia id
Irán, República Islámica de ir
Irak iq
Irlanda ie
Israel il
Italia it
Jamaica JM
Japón jp
Jordania jo
Kazajistán kz
Kenia ke
Kiribati ki
Corea, República Democrática Popular de kp
República de Corea kr
Kuwait kw
Kirguistán kg
República Democrática Popular Lao la
Letonia lv
Líbano lb
Lesoto ls
Liberia lr
Yamahiriya Árabe Libia ly
Liechtenstein li
Lituania lt
Luxemburgo lu
Macao mes
Macedonia, Antigua República Yugosalva de mk
Madagascar mg
Malaui mw
Malasia my
Maldivas mv
Malí ml
Malta mt
Islas Marshall mh
Martinica mq
Mauritania mr
Mauricio mu
Mayotte yt
México mx
Estados Federados de Micronesia fm
República de Moldavia md
Mónaco mc
Mongolia mn
Montserrat ms
Marruecos ma
Mozambique mz
Birmania mm
Namibia na
Nauru nr
Nepal np
Países Bajos nl
Antillas Neerlandesas Un
Nueva Caledonia nc
Nueva Zelanda nz
Nicaragua ni
Níger ne
Nigeria ng
Niue nuevo
Isla Norfolk nf
Islas Marianas del Norte mp
Noruega no
Omán om
Pakistán pk
Palaos pw
Territorios Palestinos Ocupados ps
Panamá pa
Papúa Nueva Guinea pág.
Paraguay py
Perú pe
Filipinas ph
Islas Pitcairn n/a
Polonia pl
Portugal pt
Puerto Rico pr
Catar qa
Reunión volver
Rumania ro
Federación Rusa ru
Ruanda rw
Santa Elena sh
San Cristóbal y Nieves kn
Santa Lucía lc
San Pedro y Miquelón p.m.
San Vicente y las Granadinas vc
Samoa ws
San Marino sm
Santo Tomé y Príncipe st
Arabia Saudita sa
Senegal sn
Serbia y Montenegro cs
Seychelles sc
Sierra Leona sl
Singapur sg
Eslovaquia sk
Eslovenia si
Islas Salomón sb
Somalia so
Sudáfrica za
Islas Georgias del Sur y Sandwich del Sur gs
España es
Sri Lanka l
Sudán sd
Surinam sr
Svalbard y Jan Mayen sj
Suazilandia sz
Suecia se
Suiza ch
República Árabe Siria sy
Taiwán, provincia de China tw
Tayikistán TJ
República Unida de Tanzania tz
Tailandia th
Timor Oriental tl
Togo tg
Tokelau tk
Tonga para
Trinidad y Tobago tt
Túnez tn
Türkiye tr
Turkmenistán tm
Islas Turcas y Caicos tc
Tuvalu tv
Uganda ug
Ucrania ua
Emiratos Árabes Unidos ae
Reino Unido uk
Estados Unidos us
Islas Ultramarinas Menores de los Estados Unidos eh...
Uruguay uy
Uzbekistán uz
Vanuatu vu
Venezuela ve
Vietnam vn
Islas Vírgenes Británicas vg
Islas Vírgenes, EE.UU. vi
Wallis y Futuna wf
Sahara Occidental eh
Yemen
Zambia zm
Zimbabue ZW