핵심 메서드 참조

이 문서에서는 핵심 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'.

});