google.script.url 클래스 (클라이언트 측 API)

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

google.script.url는 URL을 쿼리하여 현재 URL 매개변수와 프래그먼트를 가져올 수 있는 비동기 클라이언트 측 자바스크립트 API입니다. 이 API는 google.script.history API를 지원합니다. IFRAME를 사용하는 웹 앱의 컨텍스트에서만 사용할 수 있습니다. 부가기능 또는 컨테이너 스크립트 컨텍스트의 사이드바 및 대화상자와 함께 사용하기 위한 용도는 아닙니다. 자세한 내용은 웹 앱의 브라우저 기록 사용 가이드를 참고하세요.

메서드

메서드반환 유형간략한 설명
getLocation(function) void URL 위치 객체를 가져와 지정된 콜백 함수에 전달합니다.

자세한 문서

getLocation(function)

URL 위치 객체를 가져와서 지정된 콜백 함수 (유일한 인수로)에 전달합니다.

index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

매개변수

이름유형설명
functionFunction위치 객체를 유일한 인수로 사용하여 실행할 클라이언트 측 콜백 함수입니다.

위치 객체

다음 표는 URL이 쿼리된 경우 지정될 위치 요소의 예를 보여줍니다. http://www.example.com?n=1&name=alice&n=2#headingAnchor
필드
location.hash

# 문자 뒤에 오는 URL 프래그먼트의 문자열 값입니다. URL 프래그먼트가 없는 경우 빈 문자열입니다.

headingAnchor
location.parameter

URL 요청 매개변수에 해당하는 키-값 쌍의 객체입니다. 값이 여러 개인 매개변수에 대해 첫 번째 값만 반환됩니다. 매개변수가 없으면 빈 객체가 됩니다.

{"name": "alice", "n": "1"}
location.parameters

location.parameter와 유사하지만 각 키의 값 배열이 있는 객체입니다. 매개변수가 없으면 빈 객체가 됩니다.

{"name": ["alice"], "n": ["1", "2"]}