Skip to main content
어트리뷰션 요청은 비즈니스 소유자가 수락해야만 효력이 발생합니다. Partner Referral Requests API를 사용하여 추천 링크를 생성하고 어트리뷰션 요청을 보낼 수 있습니다. 또한 보내거나 받은 링크와 요청의 목록을 조회하고, 대기 중인 요청을 수락, 거절 또는 취소할 수 있습니다.

엔드포인트

속성

string
필수
파트너 추천 요청 ID로, 접두사는 prfr_입니다.
object | null
필수
요청을 받는 비즈니스입니다(지정된 경우).

속성

string
필수
계정 ID로, 접두사는 biz_입니다.
string
필수
계정 표시 이름입니다.
string | null
필수
이 추천이 생성된 파트너의 팀 멤버십으로, 접두사는 ausr_입니다. 개인 추천인 경우 null입니다.
string | null
필수
고유 추천 코드입니다(지정된 경우).
string
필수
요청이 생성된 시점으로, ISO 8601 타임스탬프입니다.
integer | null
필수
허용되는 최대 사용 횟수입니다(제한된 경우).
string | null
필수
해당 비즈니스에서의 파트너 역할이 멤버 레코드에 보관된 경우, 이 추천이 생성된 파트너의 멤버 레코드로, 접두사는 mber_입니다. 그 외의 경우 null입니다.
object
필수
요청한 파트너의 공개 프로필입니다.

속성

string
필수
사용자 ID로, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
object | null
필수
추천이 파트너의 팀에 속한 경우, 파트너가 이 요청을 대신 보낸 비즈니스입니다. 개인 추천인 경우 null입니다.

속성

string
필수
계정 ID로, 접두사는 biz_입니다.
string
필수
계정 표시 이름입니다.
string
필수
추천 요청이 시작된 방식입니다.사용 가능한 옵션: manual, ownership_transfer, link
object[]
필수
이 요청이 제공하는 보상입니다.

속성

string
필수
파트너 보상 ID로, 접두사는 prwd_입니다.
string | null
필수
이 보상의 자격 요건이 되는 활동입니다(지정된 경우).사용 가능한 옵션: sales, ad_spend
object
필수
보상을 받기 위해 필요한 자격 활동의 USD 금액입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
보상 수령인의 역할이며, 요청한 파트너가 아닌 고정된 사용자인 경우 null입니다.사용 가능한 옵션: business, partner
string | null
필수
실제 수령인의 사용자 또는 비즈니스 ID이며, 비즈니스가 오퍼를 사용하기 전까지는 null입니다.
object
필수
자격 충족 후 지급되는 USD 금액입니다.

속성

string
필수
기본 단위의 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드입니다.
integer
필수
금액이 가지는 소수 자릿수입니다. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수입니다. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string | null
필수
승인 상태이며, 승인 절차가 없는 요청의 경우 null입니다.사용 가능한 옵션: pending, accepted, denied, cancelled
string
필수
요청이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다.
object | null
필수
어트리뷰션 요청이 전송된 사용자입니다. 지원 중단됨: 사용자 대상 요청은 종료되었습니다. 항상 null입니다. DEPRECATED: 더 이상 값이 채워지지 않습니다. 항상 null입니다.

속성

string
필수
사용자 ID로, 접두사는 user_입니다.
string | null
필수
표시 이름입니다.
object
필수
아바타 래퍼입니다. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름입니다.
PartnerReferralRequest