핵심 메서드 참조

이 문서에서는 핵심 Embed API 메서드에 관한 참조와 함께 이러한 메서드가 Embed API 구성요소 및 기본 애널리틱스 클라이언트 라이브러리와 상호작용하는 방식을 간략히 설명합니다.

핵심 방법

Embed API의 핵심 메서드는 gapi.analytics 객체에 있는 메서드입니다.

`ready`

Embed API 라이브러리가 완전히 로드되는 즉시 호출될 콜백 함수를 대기열에 넣습니다. 콜백은 추가된 순서대로 호출됩니다.

ready 함수는 Embed API 스니펫으로 정의되므로 즉시 사용할 수 있습니다. 다른 모든 함수는 호출 전에 라이브러리가 로드되도록 ready 콜백 내에 배치해야 합니다.

사용량

gapi.analytics.ready(callback)

매개변수

이름	유형	설명
`callback`	`Function`	Embed API 라이브러리가 완전히 로드되는 즉시 호출될 함수입니다.

예

gapi.analytics.ready(function() {
  // Code in here will be invoked once the library fully loads.
});

`createComponent`

지정된 이름과 프로토타입 메서드로 구성요소를 만듭니다. 생성된 구성요소는 전달된 이름으로 gapi.analytics.ext에 저장됩니다.

createCallback 함수는 항상 준비된 콜백 내에서 호출하여 Embed API 클라이언트 라이브러리가 로드되도록 해야 합니다.

사용량

gapi.analytics.createComponent(name, prototypeMethods)

매개변수

이름	유형	설명
`name`	`string`	구성요소의 이름입니다.
`prototypeMethods`	`Object`	해당 속성과 메서드가 구성요소의 프로토타입에 저장됩니다.

예

gapi.analytics.ready(function() {

  gapi.analytics.createComponent('MyComponent', {
    foo: function() {
      alert('foo');
    },
    bar: function() {
      alert('bar');
    }
  });

  var myComponentInstance = new gapi.analytics.ext.MyComponent();
  myComponentInstance.foo(); // Alerts 'foo'.

});