A rebuilt version of Sites was launched on November 22, 2016. The Sites API cannot access or modify Sites made with this version, but can still access classic Sites.

Guia de referência

Este documento apresenta documentação detalhada de referência para o protocolo bruto (XML e HTTP) da API de dados do Google Sites.

Este documento não contém informações sobre as bibliotecas de cliente da linguagem de programação. Para informações de referência da biblioteca de cliente, consulte os links das seções específicas da linguagem de programação do guia do desenvolvedor.

Público-alvo

Este documento é destinado aos programadores que querem criar aplicativos cliente que possam interagir com o Google Sites.

É um documento de referência. Ele pressupõe que você entende os conceitos apresentados no guia de protocolo e as ideias gerais por trás do protocolo das APIs de dados do Google.

Tipos de feed do Google Sites

A API Google Data Data fornece os seguintes tipos de feed:

Feed de atividade

O feed de atividades é um feed que contém descrições de todas as atividades em um site.

O URI de GET deste feed para um site em um domínio específico é:

https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]

domainName é um domínio "site" ou do G Suite.

siteName é o nome do site como aparece no URL da página de destino do site: http://sites.google.com/a/domainName/siteName/.

Todas as solicitações para este feed precisam ser autenticadas.

Tipos de solicitação compatíveis: GET

Feed de conteúdo

O feed de conteúdo é um feed que inclui o conteúdo de site atual e editável.

O URI de GET deste feed para um site em um domínio específico é:

https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]

domainName é um domínio "site" ou do G Suite.

siteName é o nome do site como aparece no URL da página de destino do site: http://sites.google.com/a/domainName/siteName.

As solicitações para esse feed podem ou não exigir autenticação, dependendo das configurações do site (publicadas).

Tipos de solicitação compatíveis: GET, POST, PUT e DELETE

Além dos parâmetros de consulta padrão da API Data, a API Sites Data permite os seguintes parâmetros opcionais que emitem a solicitação GET usando o feed de conteúdo:

Parâmetro Descrição Tipo Observações
ancestor Solicita apenas entradas que têm o ancestral especificado. string Forneça o ID da entrada ancestral desejada. Por exemplo: 0123456789. Retorna todas as entradas que têm o ancestral especificado como pai, pai de pai e assim por diante.
include-deleted Especifica se serão incluídas entradas excluídas. boolean Os valores possíveis são true ou false. O padrão é false.
include-draft Especifica se serão incluídas entradas de rascunho. boolean Os valores possíveis são true ou false. O padrão é false. Para visualizar o rascunho, é necessário ser o proprietário ou autor dele.
kind Especifica os tipos de entradas de conteúdo a serem retornadas. Elas seguem o tipo de página no Google Sites. lista de strings separada por vírgulas Os valores possíveis são announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template.
parent Solicita apenas entradas que têm o pai especificado. string Informe o ID da entrada pai. Por exemplo: 0123456789.
path Solicita conteúdo em uma determinada hierarquia de páginas. string O caminho para uma subpágina em que um site deve buscar conteúdo. Por exemplo: path=/path/to/page.

Feed de revisão

O feed de revisão é um feed que contém revisões históricas do conteúdo do site.

O URI de GET deste feed para um site em um domínio específico é:

https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]

domainName é um domínio "site" ou do G Suite.

siteName é o nome do site como aparece no URL da página de destino do site: http://sites.google.com/a/domainName/siteName.

Todas as solicitações para este feed precisam ser autenticadas.

Tipos de solicitação compatíveis: GET

Feed do site

O feed de sites pode ser usado para listar os sites do Google que um usuário tem ou tem permissões de visualização. Também é possível usá-lo para criar sites, copiar sites ou modificar o nome de um site existente.

O URI do feed da ficha do Sites é:

https://sites.google.com/feeds/site/domainName/[siteName]

domainName é um domínio "site" ou do G Suite.

Todas as solicitações para este feed precisam ser autenticadas.

Tipos de solicitação compatíveis: GET, POST e PUT

O feed do site é compatível com os seguintes parâmetros (opcional) ao emitir uma solicitação GET para listar sites:

Parâmetro Descrição Tipo Observações
include-all-sites Liste todos os sites que podem ser visualizados pelo menos no domínio do G Suite. boolean Esse parâmetro só é aplicável ao listar sites de um domínio do G Suite. Os valores possíveis são true ou false. O padrão é false.
with-mappings Inclui os mapeamentos de endereços da Web em uma entrada do site. boolean Os valores possíveis são true ou false. O padrão é false.

Feed da ACL

O feed de ACL pode ser usado para listar e/ou modificar as permissões de compartilhamento (ACLs) de um site Google.

O URI do feed da ficha do Sites é:

https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]

domainName é um domínio "site" ou do G Suite.

Todas as solicitações para este feed precisam ser autenticadas.

Tipos de solicitação compatíveis: GET, POST, PUT e DELETE

Referência de parâmetros de consulta do Google Sites

Parâmetros de consulta compatíveis do protocolo da API Google Data:

  • max-results
  • published-max (somente feed de conteúdo)
  • published-min (somente feed de conteúdo)
  • start-index
  • updated-max
  • updated-min
  • q (consultas de texto completas)

Consulte cada feed acima para ver uma lista de parâmetros específicos.

Voltar ao início