참조 가이드

이 문서에서는 Google Sites Data API의 원시 프로토콜 (XML 및 HTTP)에 대한 자세한 참조 문서를 제공합니다.

이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보를 보려면 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 확인하세요.

대상

이 문서는 Google 사이트 도구와 상호작용할 수 있는 클라이언트 애플리케이션을 작성하려는 프로그래머를 위해 작성되었습니다.

이 문서는 참조 문서이며, 프로토콜 가이드에 있는 개념과 Google 데이터 API 프로토콜의 일반적인 개념을 이해하고 있다고 가정합니다.

Google Sites 피드 유형

Google Sites Data API는 다음 유형의 피드를 제공합니다.

활동 피드

활동 피드는 사이트 내 모든 활동에 대한 설명이 포함된 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

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

domainName은 '사이트' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName/)에 표시되는 사이트 이름입니다.

이 피드에 대한 모든 요청은 인증을 받아야 합니다.

지원되는 요청 유형: GET

콘텐츠 피드

콘텐츠 피드는 수정 가능한 현재의 사이트 콘텐츠가 포함된 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

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

domainName은 '사이트' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.

이 피드에 대한 요청은 사이트 (게시됨) 설정에 따라 인증이 필요하거나 필요하지 않을 수 있습니다.

지원되는 요청 유형: GET, POST, PUT, DELETE

Sites Data API를 사용하면 표준 Data API 쿼리 매개변수 외에도 콘텐츠 피드를 사용하여 GET 요청을 실행하는 다음과 같은 선택적 매개변수를 사용할 수 있습니다.

매개변수 설명 유형 Notes
ancestor 지정된 상위 항목이 있는 항목만 요청합니다. string 원하는 상위 항목의 ID를 제공합니다. 예를 들면 0123456789입니다. 지정된 상위가 상위, 상위의 상위 등인 모든 항목을 반환합니다.
include-deleted 삭제된 항목을 포함할지 여부를 지정합니다. boolean 가능한 값은 true 또는 false입니다. 기본값은 false입니다.
include-draft 초안 항목을 포함할지 여부를 지정합니다. boolean 가능한 값은 true 또는 false입니다. 기본값은 false입니다. 초안을 보려면 초안의 소유자 또는 작성자여야 합니다.
kind 반환할 콘텐츠 항목의 종류를 지정합니다. Google Sites 내 페이지 유형을 따릅니다. 쉼표로 구분된 문자열 목록 가능한 값은 announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template입니다.
parent 지정된 상위 항목이 있는 항목만 요청합니다. string 상위 항목의 ID를 제공합니다. 예를 들면 0123456789입니다.
path 특정 페이지 계층 구조의 콘텐츠를 요청 string 콘텐츠를 가져올 사이트 내 하위 페이지의 경로입니다. 예를 들면 path=/path/to/page입니다.

버전 피드

버전 피드는 사이트 콘텐츠의 이전 버전이 포함된 피드입니다.

특정 도메인 내 사이트에 대한 이 피드의 GET URI는 다음과 같습니다.

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

domainName은 '사이트' 또는 G Suite 도메인입니다.

siteName은 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.

이 피드에 대한 모든 요청은 인증을 받아야 합니다.

지원되는 요청 유형: GET

사이트 피드

사이트 피드는 사용자가 소유하거나 보기 권한이 있는 Google Sites를 나열하는 데 사용할 수 있습니다. 또한 새 사이트를 만들거나, 사이트를 복사하거나, 기존 사이트의 이름을 수정할 때도 사용할 수 있습니다.

Sites 비즈니스 정보의 피드 URI는 다음과 같습니다.

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

domainName은 '사이트' 또는 G Suite 도메인입니다.

이 피드에 대한 모든 요청은 인증을 받아야 합니다.

지원되는 요청 유형: GET, POST, PUT

사이트 피드는 사이트 등록정보를 위한 GET 요청을 실행할 때 다음 (선택사항) 매개변수를 지원합니다.

매개변수 설명 유형 Notes
include-all-sites G Suite 도메인 내 사용자가 최소한으로 볼 수 있는 모든 사이트를 나열합니다. boolean 이 매개변수는 G Suite 도메인의 사이트를 나열할 때만 적용됩니다. 가능한 값은 true 또는 false입니다. 기본값은 false입니다.
with-mappings 사이트 항목에 웹 주소 매핑이 포함됩니다. boolean 가능한 값은 true 또는 false입니다. 기본값은 false입니다.

ACL 피드

ACL 피드는 Google Sites로 만든 사이트의 공유 권한 (ACL)을 나열하거나 수정하는 데 사용할 수 있습니다.

Sites 비즈니스 정보의 피드 URI는 다음과 같습니다.

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

domainName은 '사이트' 또는 G Suite 도메인입니다.

이 피드에 대한 모든 요청은 인증을 받아야 합니다.

지원되는 요청 유형: GET, POST, PUT, DELETE

Google Sites 쿼리 매개변수 참조

Google Data API 프로토콜에서 지원되는 쿼리 매개변수:

  • max-results
  • published-max (콘텐츠 피드만)
  • published-min (콘텐츠 피드만)
  • start-index
  • updated-max
  • updated-min
  • q (전체 텍스트 쿼리)

해당 피드와 관련된 매개변수 목록은 위의 각 피드를 참고하세요.

맨 위로