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

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

방법

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

자세한 문서

getLocation(function)

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

Index.html

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

매개변수

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

위치 객체

다음 표에는 http://www.example.com?n=1&name=alice&n=2#headingAnchor URL을 쿼리하면 지정되는 위치 요소의 예가 나와 있습니다.

필드
location.hash	# 문자 뒤에 오는 URL 프래그먼트의 문자열 값 또는 URL 프래그먼트가 없는 경우 빈 문자열 headingAnchor
location.parameter	URL 요청 매개변수에 해당하는 키-값 쌍의 객체입니다. 값이 여러 개인 매개변수의 경우 첫 번째 값만 반환됩니다. 매개변수가 없으면 빈 객체가 됩니다. {"name": "alice", "n": "1"}
location.parameters	location.parameter와 유사하지만 각 키의 값 배열이 있는 객체입니다. 매개변수가 없으면 빈 객체가 됩니다. {"name": ["alice"], "n": ["1", "2"]}

---