이 문서에서는 Google Sites Data API의 원시 프로토콜 (XML 및 HTTP)에 관한 자세한 참조 문서를 제공합니다.
이 문서에는 프로그래밍 언어 클라이언트 라이브러리에 대한 정보가 포함되어 있지 않습니다. 클라이언트 라이브러리 참조 정보는 개발자 가이드의 프로그래밍 언어별 섹션에 있는 링크를 참고하세요.
잠재고객
이 문서는 Google Sites와 상호작용할 수 있는 클라이언트 애플리케이션을 작성하려는 프로그래머를 대상으로 합니다.
참고 문서이므로 프로토콜 가이드에 제시된 개념과 Google Data API 프로토콜의 일반적인 아이디어를 이해하고 있다고 가정합니다.
Google Sites 피드 유형
Google Sites Data API는 다음과 같은 유형의 피드를 제공합니다.
활동 피드
활동 피드는 사이트 내 모든 활동의 설명이 포함된 피드입니다.
특정 도메인 내 사이트의 이 피드 GET URI는 다음과 같습니다.
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName은 'site' 또는 G Suite 도메인입니다.
siteName는 사이트 방문 페이지 URL(http://sites.google.com/a/domainName/siteName/)에 표시되는 사이트 이름입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET
콘텐츠 피드
콘텐츠 피드는 현재 편집 가능한 사이트 콘텐츠를 포함하는 피드입니다.
특정 도메인 내 사이트의 이 피드 GET URI는 다음과 같습니다.
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName은 'site' 또는 G Suite 도메인입니다.
siteName는 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.
이 피드에 대한 요청은 사이트의 (게시된) 설정에 따라 인증이 필요할 수도 있고 필요하지 않을 수도 있습니다.
지원되는 요청 유형: GET, POST, PUT, DELETE
Sites Data API를 사용하면 표준 Data API 쿼리 매개변수 외에도 콘텐츠 피드를 사용하여 GET 요청을 실행하는 다음 선택적 매개변수를 사용할 수 있습니다.
| 매개변수 | 설명 | 유형 | 참고 |
|---|---|---|---|
ancestor |
지정된 상위 항목이 있는 항목만 요청합니다. | 문자열 | 원하는 상위 항목의 ID를 제공합니다. 예: 0123456789 지정된 상위 항목이 상위, 상위의 상위 등으로 있는 모든 항목을 반환합니다. |
include-deleted |
삭제된 항목을 포함할지 여부를 지정합니다. | 부울 | 가능한 값은 true 또는 false입니다. 기본값은 false입니다. |
include-draft |
초안 항목을 포함할지 여부를 지정합니다. | 부울 | 가능한 값은 true 또는 false입니다. 기본값은 false입니다. 초안을 보려면 초안의 소유자 또는 작성자여야 합니다. |
kind |
반환할 콘텐츠 항목의 종류를 지정합니다. 이는 Google 사이트 도구 내 페이지 유형을 따릅니다. | 쉼표로 구분된 문자열 목록 | 가능한 값은 announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template입니다. |
parent |
지정된 상위 항목이 있는 항목만 요청합니다. | 문자열 | 상위 항목의 ID를 제공합니다. 예: 0123456789 |
path |
특정 페이지 계층 구조에 따라 콘텐츠를 요청합니다. | 문자열 | 콘텐츠를 가져올 사이트 내 하위 페이지의 경로입니다. 예: path=/path/to/page |
버전 피드
버전 피드는 사이트 콘텐츠의 이전 버전을 포함하는 피드입니다.
특정 도메인 내 사이트의 이 피드 GET URI는 다음과 같습니다.
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName은 'site' 또는 G Suite 도메인입니다.
siteName는 사이트의 방문 페이지 URL(http://sites.google.com/a/domainName/siteName)에 표시되는 사이트 이름입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET
사이트 피드
사이트 피드를 사용하면 사용자가 소유하거나 보기 권한이 있는 Google Sites를 나열할 수 있습니다. 새 사이트를 만들거나, 사이트를 복사하거나, 기존 사이트의 이름을 수정하는 데도 사용할 수 있습니다.
사이트 등록정보의 피드 URI는 다음과 같습니다.
https://sites.google.com/feeds/site/domainName/[siteName]
domainName은 'site' 또는 G Suite 도메인입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET, POST, PUT
사이트 피드는 사이트 목록을 가져오기 위한 GET 요청을 발행할 때 다음 선택적 매개변수를 지원합니다.
| 매개변수 | 설명 | 유형 | 참고 |
|---|---|---|---|
include-all-sites |
G Suite 도메인에서 사용자가 볼 수 있는 모든 사이트를 나열합니다. | 부울 | 이 파라미터는 G Suite 도메인의 사이트를 나열할 때만 적용됩니다. 가능한 값은 true 또는 false입니다. 기본값은 false입니다. |
with-mappings |
사이트 항목에 웹 주소 매핑을 포함합니다. | 부울 | 가능한 값은 true 또는 false입니다. 기본값은 false입니다. |
ACL 피드
ACL 피드를 사용하여 Google 사이트의 공유 권한 (ACL)을 나열하거나 수정할 수 있습니다.
사이트 등록정보의 피드 URI는 다음과 같습니다.
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName은 'site' 또는 G Suite 도메인입니다.
이 피드에 대한 모든 요청은 인증되어야 합니다.
지원되는 요청 유형: GET, POST, PUT, DELETE
Google Sites 쿼리 매개변수 참조
Google Data API 프로토콜에서 지원되는 쿼리 매개변수:
max-resultspublished-max(콘텐츠 피드만 해당)published-min(콘텐츠 피드만 해당)start-indexupdated-maxupdated-minq(전체 텍스트 쿼리)
각 피드에 해당하는 매개변수 목록은 위의 각 피드를 참고하세요.