다음을 통해 공유


BitlyIP(독립 게시자)

Bitly는 세계에서 가장 널리 신뢰할 수 있는 링크 관리 플랫폼입니다. Bitly API를 사용하면 자동화된 링크 사용자 지정, 모바일 딥 링크 및 클릭 분석을 통해 링크의 모든 기능을 발휘합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 트로이 테일러
URL https://www.hitachisolutions.com
전자 메일 ttaylor@hitachisolutions.com
커넥터 메타데이터
게시자 트로이 테일러
웹 사이트 https://bitly.com/
개인 정보 보호 정책 https://bitly.com/pages/privacy
카테고리 소셜 미디어; 웹 사이트

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
API 키 시큐어스트링 (보안 문자열) 이 API의 API 키 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

Bitlink QR 코드 가져오기

Bitlink에 대한 QR 코드를 생성합니다.

Bitlink 업데이트

지정된 링크의 필드를 업데이트합니다.

Bitlink 확장

지정된 링크의 짧은 링크와 긴 URL을 반환합니다.

Bitlink에 대한 클릭 가져오기

날짜에 따라 배열의 지정된 링크에 대한 클릭 수를 반환합니다.

Bitlink에 대한 클릭 요약 가져오기

단일 필드로 롤업된 지정된 링크의 클릭 수를 반환합니다.

BSD 가져오기

모든 브랜드 짧은 도메인을 가져옵니다.

BSD에 대한 사용자 지정 비트링크 가져오기

BSD로 필터링된 조직에 대한 사용자 지정 Bitlinks를 가져옵니다.

OAuth 앱 가져오기

제공된 OAuth 앱 클라이언트 ID에 대한 세부 정보를 검색합니다.

계획 제한 가져오기

조직에 사용할 수 있는 모든 계획 제한 및 개수를 반환합니다.

국가별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽의 국가 원본을 반환합니다.

국가별 그룹 메트릭 가져오기

지정한 그룹에 대한 국가별 클릭 트래픽의 지리적 출처를 반환합니다.

그룹 가져오기

그룹에 대한 세부 정보를 반환합니다.

그룹 가져오기

조직의 그룹 목록을 반환합니다.

그룹 기본 설정 가져오기

지정된 그룹의 기본 설정을 반환합니다.

그룹 기본 설정 업데이트

그룹에 대한 기본 설정을 업데이트합니다.

그룹 단축 개수 가져오기

그룹에 대한 모든 단축 횟수를 반환합니다.

그룹 업데이트

그룹의 세부 정보를 업데이트합니다.

그룹 클릭 가져오기

그룹의 Bitlinks 클릭 횟수를 가져옵니다.

그룹 태그 가져오기

지정된 그룹에 현재 사용되는 태그를 반환합니다. 최대 1000.

그룹별 비트링크 가져오기

그룹에 대해 페이지를 매긴 Bitlinks 컬렉션을 반환합니다.

그룹별 비트링크 업데이트

대량 업데이트는 태그를 추가하거나 제거하거나 한 번에 최대 100개의 링크를 보관할 수 있습니다. 응답에는 업데이트된 Bitlink ID 목록이 포함됩니다.

네트워크를 참조하여 그룹 메트릭 가져오기

지정된 그룹의 링크에 대한 네트워크를 참조하여 메트릭을 반환합니다.

대상별 사용자 지정 Bitlink 메트릭 가져오기

기록 대상에서 지정한 링크에 대한 클릭 메트릭을 반환합니다.

도메인별 참조자별 Bitlink에 대한 메트릭 가져오기

지정한 링크에 대한 참조자별로 그룹화된 클릭 메트릭을 반환합니다.

도메인을 참조하여 Bitlink에 대한 메트릭 가져오기

지정한 링크의 참조 도메인 클릭 수를 반환합니다.

도시별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽의 도시 원본을 반환합니다.

도시별 그룹 메트릭 가져오기

지정된 그룹에 대한 도시별 클릭 트래픽의 지리적 출처를 반환합니다.

디바이스별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽을 생성하는 디바이스 유형을 반환합니다.

디바이스별 그룹 메트릭 가져오기

지정된 그룹의 링크에 대한 클릭 트래픽을 생성하는 디바이스 유형을 반환합니다.

비트링크 가져오기

지정된 링크에 대한 정보를 반환합니다.

비트링크 만들기

긴 URL을 비트링크로 변환합니다.

사용자 가져오기

현재 인증된 사용자에 대한 정보를 반환합니다.

사용자 업데이트

사용자의 필드 업데이트

사용자 지정 Bitlink 업데이트

키워드(또는 사용자 지정 백 하프)를 다른 Bitlink로 이동합니다.

사용자 지정 Bitlink 추가

사용자 지정 도메인을 사용하여 Bitlink에 키워드(또는 사용자 지정 백 하프)를 추가합니다. 이 엔드포인트는 링크로의 초기 리디렉션에도 사용할 수 있습니다.

사용자 지정 Bitlink에 대한 클릭 가져오기

지정된 링크의 클릭 수를 반환합니다. 날짜에 따라 클릭이 있는 배열을 반환합니다.

사용자 지정 비트링크 가져오기

지정된 링크의 세부 정보 및 기록을 반환합니다.

업데이트 채널

기존 채널을 업데이트합니다.

웹후크 가져오기

웹후크를 반환합니다.

웹후크 가져오기

조직에 사용할 수 있는 모든 웹후크 가져오기

웹후크 만들기

웹후크를 만듭니다.

웹후크 삭제

웹후크를 삭제합니다.

웹후크 업데이트

웹후크 업데이트

웹후크 확인

ping 이벤트를 전송하여 웹후크 구성을 테스트합니다.

전체 비트링크 만들기

긴 URL을 Bitlink로 변환하고 추가 매개 변수를 설정합니다.

정렬된 비트링크 가져오기

그룹별로 정렬된 Bitlinks 목록을 반환합니다.

조직 가져오기

지정된 조직에 대한 세부 정보를 검색합니다.

조직 가져오기

조직 목록을 검색합니다.

조직 단축 횟수 가져오기

지정된 기간 동안 특정 조직의 단축 횟수를 반환합니다.

참조자별 Bitlink에 대한 메트릭 가져오기

지정한 링크에 대한 참조자 클릭 수를 반환합니다.

채널 가져오기

채널의 세부 정보를 반환합니다.

채널 가져오기

사용자가 사용할 수 있는 채널을 반환합니다.

채널 만들기

새 채널을 만듭니다.

채널에 비트링크 대량 추가

여러 캠페인 채널에 Bitlink 대량 추가

캠페인 가져오기

캠페인에 대한 세부 정보를 반환합니다.

캠페인 가져오기

현재 인증된 사용자에 대한 캠페인을 반환합니다.

캠페인 만들기

새 캠페인을 만듭니다.

캠페인 업데이트

캠페인의 세부 정보를 업데이트합니다.

플랫폼 제한 가져오기

조직에 사용할 수 있는 모든 플랫폼 제한 및 개수 가져오기

Bitlink에 대한 QR 코드를 생성합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

색깔
color string

16진수 RGB 형식으로 표시된 색

Bitly 로고 제외
exclude_bitly_logo boolean

생성된 QR 이미지의 가운데에서 Bitly 로고를 제거합니다.

이미지 형식
image_format string

반환된 QR 코드의 이미지 형식을 결정합니다.

반환

BitlinkQR
BitlinkQR

지정된 링크의 필드를 업데이트합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

참조
references object
보관
archived boolean
tags
tags array of string
생성_시간
created_at string
title
title string
bitlink
bitlink string
install_url
install_url string
만든
created string

ISO 타임스탬프

app_uri_path
app_uri_path string
modified
modified string

ISO 타임스탬프

install_type
install_type string
app_guid
app_guid string
가이드(guid)
guid string
운영 체제
os string
brand_guid
brand_guid string
작성자
created_by string
long_url
long_url string
클라이언트_아이디
client_id string
custom_bitlinks
custom_bitlinks array of string
link
link string
launchpad_ids
launchpad_ids array of string
아이디
id string

반환

BitlinkBody
BitlinkBody

지정된 링크의 짧은 링크와 긴 URL을 반환합니다.

매개 변수

Name 필수 형식 Description
bitlink_id
bitlink_id string

반환

ExpandedBitlink
ExpandedBitlink

Bitlink에 대한 클릭 가져오기

날짜에 따라 배열의 지정된 링크에 대한 클릭 수를 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

클릭 횟수
Clicks

Bitlink에 대한 클릭 요약 가져오기

단일 필드로 롤업된 지정된 링크의 클릭 수를 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClicksSummary
ClicksSummary

BSD 가져오기

모든 브랜드 짧은 도메인을 가져옵니다.

반환

BSDsResponse
BSDsResponse

BSD에 대한 사용자 지정 비트링크 가져오기

BSD로 필터링된 조직에 대한 사용자 지정 Bitlinks를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

만든 후
created_after integer

정수 unix epoch로 타임스탬프

한계
limit integer

반환되는 결과 양을 제한합니다.

상쇄
offset integer

결과 집합의 시작 인덱스 설정

BSD
bsd array

결과를 필터링하는 브랜드의 짧은 도메인

반환

BitlinkOverridesData
BitlinkOverridesData

OAuth 앱 가져오기

제공된 OAuth 앱 클라이언트 ID에 대한 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
ID 클릭
client_id True string

OAuth 앱의 클라이언트 ID

반환

OAuthApp
OAuthApp

계획 제한 가져오기

조직에 사용할 수 있는 모든 계획 제한 및 개수를 반환합니다.

매개 변수

Name 필수 형식 Description
조직 GUID
organization_guid True string

Bitly 조직의 GUID

반환

PlanLimits
PlanLimits

국가별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽의 국가 원본을 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClickMetrics
ClickMetrics

국가별 그룹 메트릭 가져오기

지정한 그룹에 대한 국가별 클릭 트래픽의 지리적 출처를 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClickMetrics
ClickMetrics

그룹 가져오기

그룹에 대한 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

반환

그룹
Group

그룹 가져오기

조직의 그룹 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
조직 GUID
organization_guid string

Bitly 조직의 GUID

반환

Groups
Groups

그룹 기본 설정 가져오기

지정된 그룹의 기본 설정을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

반환

GroupPreferences
GroupPreferences

그룹 기본 설정 업데이트

그룹에 대한 기본 설정을 업데이트합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

group_guid
group_guid string
domain_preference
domain_preference string

반환

GroupPreferences
GroupPreferences

그룹 단축 개수 가져오기

그룹에 대한 모든 단축 횟수를 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

Metrics
Metrics

그룹 업데이트

그룹의 세부 정보를 업데이트합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

bsds
bsds array of string
이름
name string
organization_guid
organization_guid string

반환

그룹
Group

그룹 클릭 가져오기

그룹의 Bitlinks 클릭 횟수를 가져옵니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

GroupClicks
GroupClicks

그룹 태그 가져오기

지정된 그룹에 현재 사용되는 태그를 반환합니다. 최대 1000.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

반환

태그들
Tags

그룹별 비트링크 가져오기

그룹에 대해 페이지를 매긴 Bitlinks 컬렉션을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

Size
size integer

반환할 항목의 수량

페이지
page integer

시작할 번호가 매겨진 결과를 지정하는 정수입니다.

키워드
keyword string

기록 항목을 필터링하는 사용자 지정 키워드

Query
query string

검색하려는 값

이전에 만든 경우
created_before integer

정수 unix epoch로 타임스탬프

만든 후
created_after integer

정수 unix epoch로 타임스탬프

수정한 후
modified_after integer

정수 unix epoch로 타임스탬프

Archived
archived string

보관된 비트링크 포함 여부

딥링크
deeplinks string

딥링크를 포함하는 비트링크로만 필터링

도메인 딥링크
domain_deeplinks string

사용자 지정 도메인으로 구성된 딥링크를 포함하는 Bitlink로만 필터링

캠페인 GUID
campaign_guid string

지정된 캠페인 GUID에 대한 링크만 반환하는 필터를 제공할 수 있습니다.

채널 길드
channel_guid string

지정된 채널 GUID에 대한 링크만 반환하도록 필터를 지정하고, 제공할 수 있으며, 다른 모든 매개 변수를 재정의합니다.

사용자 지정 비트링크
custom_bitlink string

도메인 및 키워드로 만든 사용자 지정 비트링크

태그들
tags array

지정된 태그로 필터링

실행 패드 ID
launchpad_ids array

실행 패드 ID로 필터링

인코딩 로그인
encoding_login array

Bitlink를 만든 인증된 사용자의 로그인으로 필터링

반환

비트링크
Bitlinks

그룹별 비트링크 업데이트

대량 업데이트는 태그를 추가하거나 제거하거나 한 번에 최대 100개의 링크를 보관할 수 있습니다. 응답에는 업데이트된 Bitlink ID 목록이 포함됩니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

조치
action string
remove_tags
remove_tags array of string
archive
archive boolean
links
links array of string

이 ID는 100비트링크 ID로 제한됩니다.

add_tags
add_tags array of string

반환

BulkUpdate
BulkUpdate

네트워크를 참조하여 그룹 메트릭 가져오기

지정된 그룹의 링크에 대한 네트워크를 참조하여 메트릭을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

반환

ClickMetrics
ClickMetrics

기록 대상에서 지정한 링크에 대한 클릭 메트릭을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 비트링크
custom_bitlink True string

도메인 및 키워드로 만든 사용자 지정 비트링크

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClickMetrics
ClickMetrics

도메인별 참조자별 Bitlink에 대한 메트릭 가져오기

지정한 링크에 대한 참조자별로 그룹화된 클릭 메트릭을 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ReferrersByDomains
ReferrersByDomains

도메인을 참조하여 Bitlink에 대한 메트릭 가져오기

지정한 링크의 참조 도메인 클릭 수를 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClickMetrics
ClickMetrics

도시별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽의 도시 원본을 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

CityMetrics
CityMetrics

도시별 그룹 메트릭 가져오기

지정된 그룹에 대한 도시별 클릭 트래픽의 지리적 출처를 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

CityMetrics
CityMetrics

디바이스별 Bitlink에 대한 메트릭 가져오기

지정된 링크에 대한 클릭 트래픽을 생성하는 디바이스 유형을 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

DeviceMetrics
DeviceMetrics

디바이스별 그룹 메트릭 가져오기

지정된 그룹의 링크에 대한 클릭 트래픽을 생성하는 디바이스 유형을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

DeviceMetrics
DeviceMetrics

비트링크 가져오기

지정된 링크에 대한 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

반환

BitlinkBody
BitlinkBody

비트링크 만들기

긴 URL을 비트링크로 변환합니다.

매개 변수

Name 필수 형식 Description
group_guid
group_guid string
도메인
domain string
long_url
long_url True string

반환

ShortenBitlinkBody
ShortenBitlinkBody

사용자 가져오기

현재 인증된 사용자에 대한 정보를 반환합니다.

반환

사용자
User

사용자 업데이트

사용자의 필드 업데이트

매개 변수

Name 필수 형식 Description
default_group_guid
default_group_guid string
이름
name string

반환

사용자
User

키워드(또는 사용자 지정 백 하프)를 다른 Bitlink로 이동합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 비트링크
custom_bitlink True string

도메인 및 키워드로 만든 사용자 지정 비트링크

bitlink_id
bitlink_id string

반환

CustomBitlink
CustomBitlink

사용자 지정 도메인을 사용하여 Bitlink에 키워드(또는 사용자 지정 백 하프)를 추가합니다. 이 엔드포인트는 링크로의 초기 리디렉션에도 사용할 수 있습니다.

매개 변수

Name 필수 형식 Description
bitlink_id
bitlink_id string
custom_bitlink
custom_bitlink string

반환

CustomBitlink
CustomBitlink

사용자 지정 Bitlink에 대한 클릭 가져오기

지정된 링크의 클릭 수를 반환합니다. 날짜에 따라 클릭이 있는 배열을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 비트링크
custom_bitlink True string

도메인 및 키워드로 만든 사용자 지정 비트링크

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

클릭 횟수
Clicks

사용자 지정 비트링크 가져오기

지정된 링크의 세부 정보 및 기록을 반환합니다.

매개 변수

Name 필수 형식 Description
사용자 지정 비트링크
custom_bitlink True string

도메인 및 키워드로 만든 사용자 지정 비트링크

반환

CustomBitlink
CustomBitlink

업데이트 채널

기존 채널을 업데이트합니다.

매개 변수

Name 필수 형식 Description
채널 GUID
channel_guid True string

비트 채널의 GUID

group_guid
group_guid string
가이드(guid)
guid string
이름
name string
modified
modified string

ISO_TIMESTAMP

만든
created string

ISO 타임스탬프

campaign_guid
campaign_guid string
bitlink_id
bitlink_id string

반환

채널
Channel

웹후크 가져오기

웹후크를 반환합니다.

매개 변수

Name 필수 형식 Description
웹후크 GUID
webhook_guid True string

비트 웹후크의 GUID

반환

Webhook
Webhook

웹후크 가져오기

조직에 사용할 수 있는 모든 웹후크 가져오기

매개 변수

Name 필수 형식 Description
조직 GUID
organization_guid True string

Bitly 조직의 GUID

반환

웹훅들
Webhooks

웹후크 만들기

웹후크를 만듭니다.

매개 변수

Name 필수 형식 Description
이름
name True string
url
url True string
group_guid
group_guid string
fetch_tags
fetch_tags boolean
is_active
is_active boolean
organization_guid
organization_guid True string
클라이언트_아이디
client_id string
클라이언트 비밀번호
client_secret string
oauth_url
oauth_url string
이벤트
event True string

반환

Webhook
Webhook

웹후크 삭제

웹후크를 삭제합니다.

매개 변수

Name 필수 형식 Description
웹후크 GUID
webhook_guid True string

비트 웹후크의 GUID

웹후크 업데이트

웹후크 업데이트

매개 변수

Name 필수 형식 Description
웹후크 GUID
webhook_guid True string

비트 웹후크의 GUID

이름
name string
url
url string
group_guid
group_guid string
fetch_tags
fetch_tags boolean
is_active
is_active boolean
organization_guid
organization_guid string
클라이언트_아이디
client_id string
클라이언트 비밀번호
client_secret string
oauth_url
oauth_url string
가이드(guid)
guid True string
이벤트
event string

반환

Webhook
Webhook

웹후크 확인

ping 이벤트를 전송하여 웹후크 구성을 테스트합니다.

매개 변수

Name 필수 형식 Description
웹후크 GUID
webhook_guid True string

비트 웹후크의 GUID

반환

Webhook
Webhook

전체 비트링크 만들기

긴 URL을 Bitlink로 변환하고 추가 매개 변수를 설정합니다.

매개 변수

Name 필수 형식 Description
도메인
domain string
title
title string
group_guid
group_guid string

항상 단축 호출에 특정 그룹 및 사용자 지정 도메인을 포함합니다.

tags
tags array of string
app_uri_path
app_uri_path string
install_type
install_type string
install_url
install_url string
app_id
app_id string
long_url
long_url True string

반환

BitlinkBody
BitlinkBody

정렬된 비트링크 가져오기

그룹별로 정렬된 Bitlinks 목록을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid True string

Bitly 그룹에 대한 GUID

Sort
sort True string

수행하려는 정렬 유형

단위
unit string

시간 단위

Units
units integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

Size
size integer

반환할 항목의 수량

반환

SortedLinks
SortedLinks

조직 가져오기

지정된 조직에 대한 세부 정보를 검색합니다.

매개 변수

Name 필수 형식 Description
조직 GUID
organization_guid True string

Bitly 조직의 GUID

반환

조직
Organization

조직 가져오기

조직 목록을 검색합니다.

반환

Organizations
Organizations

조직 단축 횟수 가져오기

지정된 기간 동안 특정 조직의 단축 횟수를 반환합니다.

매개 변수

Name 필수 형식 Description
조직 GUID
organization_guid True string

Bitly 조직의 GUID

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

Metrics
Metrics

참조자별 Bitlink에 대한 메트릭 가져오기

지정한 링크에 대한 참조자 클릭 수를 반환합니다.

매개 변수

Name 필수 형식 Description
Bitlink
bitlink True string

도메인 및 해시로 만든 Bitlink

단위
unit True string

시간 단위

Units
units True integer

데이터를 쿼리할 시간 단위를 나타내는 정수입니다. -1 전달하여 모든 시간 단위를 반환합니다.

Size
size integer

반환할 항목의 수량

단위 참조
unit_reference string

메트릭을 끌어올 가장 최근 시간을 나타내는 ISO-8601 타임스탬프입니다. 기본값은 현재 시간입니다.

반환

ClickMetrics
ClickMetrics

채널 가져오기

채널의 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
채널 GUID
channel_guid True string

비트 채널의 GUID

반환

채널
Channel

채널 가져오기

사용자가 사용할 수 있는 채널을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid string

Bitly 그룹에 대한 GUID

캠페인 GUID
campaign_guid string

Bitly 캠페인의 GUID

반환

채널
Channels

채널 만들기

새 채널을 만듭니다.

매개 변수

Name 필수 형식 Description
group_guid
group_guid string
가이드(guid)
guid string
이름
name string
modified
modified string

ISO_TIMESTAMP

만든
created string

ISO 타임스탬프

campaign_guid
campaign_guid string
bitlink_id
bitlink_id string

반환

채널
Channel

채널에 비트링크 대량 추가

여러 캠페인 채널에 Bitlink 대량 추가

매개 변수

Name 필수 형식 Description
캠페인 GUID
campaign_guid True string

Bitly 캠페인의 GUID

콘텐츠 유형 (Content-Type)
Content-Type string

콘텐츠의 형식입니다.

File
file file

파일입니다.

반환

BulkAddResponse
BulkAddResponse

캠페인 가져오기

캠페인에 대한 세부 정보를 반환합니다.

매개 변수

Name 필수 형식 Description
캠페인 GUID
campaign_guid True string

Bitly 캠페인의 GUID

반환

캠페인
Campaign

캠페인 가져오기

현재 인증된 사용자에 대한 캠페인을 반환합니다.

매개 변수

Name 필수 형식 Description
그룹 GUID
group_guid string

Bitly 그룹에 대한 GUID

반환

캠페인
Campaigns

캠페인 만들기

새 캠페인을 만듭니다.

매개 변수

Name 필수 형식 Description
group_guid
group_guid string
channel_guids
channel_guids array of string
description
description string
이름
name string

반환

캠페인
Campaign

캠페인 업데이트

캠페인의 세부 정보를 업데이트합니다.

매개 변수

Name 필수 형식 Description
캠페인 GUID
campaign_guid True string

Bitly 캠페인의 GUID

group_guid
group_guid string
channel_guids
channel_guids array of string
description
description string
이름
name string

반환

캠페인
Campaign

플랫폼 제한 가져오기

조직에 사용할 수 있는 모든 플랫폼 제한 및 개수 가져오기

매개 변수

Name 필수 형식 Description
경로
path string

정보가 요청되는 특정 경로

반환

PlatformLimits
PlatformLimits

정의

조직

Name 경로 형식 Description
참조
references object
이름
name string
bsds
bsds array of string
만든
created string
is_active
is_active boolean
modified
modified string
tier_display_name
tier_display_name string
tier_family
tier_family string
tier
tier string
역할
role string
가이드(guid)
guid string

클릭 횟수

Name 경로 형식 Description
단위
units integer
unit_reference
unit_reference string
단위
unit Unit
link_clicks
link_clicks array of LinkClicks

CustomBitlinkHistory

Name 경로 형식 Description
hash
hash string
UUID (범용 고유 식별자)
uuid string
키워드
keyword string
만든
created string
group_guid
group_guid string
first_created
first_created string
is_active
is_active boolean
long_url
long_url string
비활성화
deactivated string
bsd
bsd string
login
login string

OtherMetrics

Name 경로 형식 Description
other_city_clicks
other_city_clicks integer
no_city_clicks
no_city_clicks integer

웹훅들

Name 경로 형식 Description
웹후크
webhooks array of Webhook

Organizations

Name 경로 형식 Description
organizations
organizations array of Organization

LinkClicks

Name 경로 형식 Description
date
date string
클릭 횟수
clicks integer

PlanLimit

Name 경로 형식 Description
count
count integer
limit
limit integer
이름
name string
description
description string

DeeplinkRule

Name 경로 형식 Description
bitlink
bitlink string
install_url
install_url string
만든
created string

ISO 타임스탬프

app_uri_path
app_uri_path string
modified
modified string

ISO 타임스탬프

install_type
install_type string
app_guid
app_guid string
가이드(guid)
guid string
운영 체제
os string
brand_guid
brand_guid string

캠페인

Name 경로 형식 Description
참조
references object
이름
name string
만든
created string

ISO 타임스탬프

group_guid
group_guid string
modified
modified string

ISO 타임스탬프

작성자
created_by string
가이드(guid)
guid string
description
description string

OAuthApp

Name 경로 형식 Description
link
link string
이름
name string
클라이언트_아이디
client_id string
description
description string

채널

Name 경로 형식 Description
channels
channels array of Channel

PlatformLimits

Name 경로 형식 Description
platform_limits
platform_limits array of PlatformLimit

Pagination

Name 경로 형식 Description
합계
total integer
size
size integer
이전
prev string
page
page integer
next
next string

BSDsResponse

Name 경로 형식 Description
bsds
bsds array of string

GroupPreferences

Name 경로 형식 Description
group_guid
group_guid string
domain_preference
domain_preference string

ClicksSummary

Name 경로 형식 Description
단위
units integer
단위
unit Unit
total_clicks
total_clicks integer
unit_reference
unit_reference string

전자 메일

Name 경로 형식 Description
is_primary
is_primary boolean
is_verified
is_verified boolean
메일 주소
email string

캠페인

Name 경로 형식 Description
campaigns
campaigns array of Campaign
Name 경로 형식 Description
long_url
long_url string
생성_시간
created_at string
link
link string
아이디
id string
Name 경로 형식 Description
BitlinkBody
bitlink BitlinkBody
bitlink_history
bitlink_history array of CustomBitlinkHistory
custom_bitlink
custom_bitlink string
Name 경로 형식 Description
sorted_links
sorted_links array of ClickLink
links
links array of BitlinkBody
Name 경로 형식 Description
클릭 횟수
clicks integer
아이디
id string

PlatformLimit

Name 경로 형식 Description
endpoint
endpoint string
메서드
methods array of MethodLimit

Metric

Name 경로 형식 Description
value
value integer
key
key string

BitlinkOverridesData

Name 경로 형식 Description
total_count
total_count integer
오버라이드
overrides array of BitlinkOverrides

ReferrersByDomains

Name 경로 형식 Description
단위
units integer
패싯2
facet Facet2
referrers_by_domain
referrers_by_domain array of ReferrersByDomain
unit_reference
unit_reference string
단위
unit string

CityMetric

Name 경로 형식 Description
city
city string
region
region string
하위 리소스
subregion string
클릭 횟수
clicks integer
country
country string

그룹

Name 경로 형식 Description
참조
references object
이름
name string
bsds
bsds array of string
만든
created string
is_active
is_active boolean
modified
modified string
organization_guid
organization_guid string
역할
role string
가이드(guid)
guid string

ShortenBitlinkBody

Name 경로 형식 Description
참조
references object
보관
archived boolean
tags
tags array of string
생성_시간
created_at string
deeplinks
deeplinks array of DeeplinkRule
long_url
long_url string
custom_bitlinks
custom_bitlinks array of string
link
link string
아이디
id string

비트링크

Name 경로 형식 Description
Pagination
pagination Pagination
links
links array of BitlinkBody

태그들

Name 경로 형식 Description
tags
tags array of string

Webhook

Name 경로 형식 Description
참조
references object
status
status string
modified_by
modified_by string
이름
name string
만든
created string
url
url string
비활성화
deactivated string
fetch_tags
fetch_tags boolean
is_active
is_active boolean
modified
modified string
organization_guid
organization_guid string
클라이언트_아이디
client_id string
group_guid
group_guid string
클라이언트 비밀번호
client_secret string
oauth_url
oauth_url string
가이드(guid)
guid string
이벤트
event string

GroupClicks

Name 경로 형식 Description
단위
units integer
데이터
data array of CountItem
unit_reference
unit_reference string
단위
unit string

Groups

Name 경로 형식 Description
groups
groups array of Group

사용자

Name 경로 형식 Description
default_group_guid
default_group_guid string
이름
name string
만든
created string
is_active
is_active boolean
modified
modified string
is_sso_user
is_sso_user boolean
is_2fa_enabled
is_2fa_enabled boolean
login
login string
전자 메일
emails array of Email

BulkAddResponse

Name 경로 형식 Description
message
message string
Data1
data Data1

BitlinkQR

Name 경로 형식 Description
qr_code
qr_code string

QR Code 이미지의 데이터 URI

link
link string
아이디
id string

CityMetrics

Name 경로 형식 Description
단위
units integer
패싯1
facet Facet1
unit_reference
unit_reference string
단위
unit string
metrics
metrics array of CityMetric
OtherMetrics
other_metrics OtherMetrics

BulkUpdate

Name 경로 형식 Description
links
links array of string

MethodLimit

Name 경로 형식 Description
count
count integer
limit
limit integer
이름
name string

DeviceMetrics

Name 경로 형식 Description
단위
units integer
패싯1
facet Facet1
unit_reference
unit_reference string
단위
unit string
metrics
metrics array of DeviceMetric

BitlinkBody

Name 경로 형식 Description
참조
references object
보관
archived boolean
tags
tags array of string
생성_시간
created_at string
title
title string
deeplinks
deeplinks array of DeeplinkRule
작성자
created_by string
long_url
long_url string
클라이언트_아이디
client_id string
custom_bitlinks
custom_bitlinks array of string
link
link string
launchpad_ids
launchpad_ids array of string
아이디
id string

ClickMetrics

Name 경로 형식 Description
단위
units integer
패싯1
facet Facet1
unit_reference
unit_reference string
단위
unit string
metrics
metrics array of ClickMetric

채널

Name 경로 형식 Description
group_guid
group_guid string
가이드(guid)
guid string
이름
name string
modified
modified string

ISO_TIMESTAMP

만든
created string

ISO 타임스탬프

참조
references object

DeviceMetric

Name 경로 형식 Description
클릭 횟수
clicks integer
device_type
device_type string

Metrics

Name 경로 형식 Description
단위
units integer
패싯1
facet Facet1
unit_reference
unit_reference string
단위
unit string
metrics
metrics array of Metric

ClickMetric

Name 경로 형식 Description
클릭 횟수
clicks integer
value
value string

CountItem

Name 경로 형식 Description
count
count integer
ts
ts string

ReferrersByDomain

Name 경로 형식 Description
참조
referrers array of Metric
네트워크
network string

PlanLimits

Name 경로 형식 Description
참조
references object
organization_guid
organization_guid string
plan_limits
plan_limits array of PlanLimit

BitlinkOverrides

Name 경로 형식 Description
참조
references object
만든
created string
규칙
rules string
group_guid
group_guid string
modified
modified string
version
version integer
link
link string

사용할 Bitly 링크인 재정의에 대한 정규화된 URL입니다. 예: https://foo.com/bar

아이디
id string

Data1

Name 경로 형식 Description
link_save_failures
link_save_failures integer
keyword_failures
keyword_failures integer
results
results array of string
성공
successes integer
channel_bitlink_failures
channel_bitlink_failures integer
csv_format_failures
csv_format_failures integer

패싯1

패싯1
string

패싯2

패싯2
string

단위

단위
string