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-resultspublished-max(somente feed de conteúdo)published-min(somente feed de conteúdo)start-indexupdated-maxupdated-minq(consultas de texto completas)
Consulte cada feed acima para ver uma lista de parâmetros específicos.