시스템 사용자 만들기, 검색 및 업데이트

만들기

관리자 시스템 사용자 토큰 또는 자체 관리자 사용자의 액세스 토큰을 사용하여 시스템 사용자를 만듭니다.

참고: 시스템 사용자는 시스템 사용자와 앱이 모두 동일한 비즈니스에 속해 있는 경우에만 앱에서 역할이 부여됩니다. 앱이 시스템 사용자를 사용하여 데이터에 액세스해야 하는데 액세스 토큰이 다른 비즈니스에 속해 있을 경우, 대신 비즈니스 대행 API를 사용하세요.

시스템 사용자 토큰을 받고 API 호출을 보내는 데 필요한 요청은 다음과 같습니다. 처음의 세 단계는 비즈니스 관리자에서도 수행할 수 있는 설정입니다. 첫 시스템 사용자를 만드는 경우, 비즈니스 관리자의 admin인 실제 사용자의 액세스 토큰을 사용합니다.

관리자 시스템 사용자 만들기 및 토큰 생성

1. 자체 관리자 사용자 액세스 토큰으로 관리자 시스템 사용자를 만듭니다.
2. 관리자 사용자의 액세스 토큰을 사용하여 관리자 시스템 사용자로 앱을 설치합니다.
3. 관리자 사용자의 액세스 토큰을 사용하여 관리자 시스템 사용자 토큰을 생성합니다.

시스템 사용자 만들기

1. 관리자 사용자 액세스 토큰을 사용하여 시스템 사용자를 만듭니다.
2. 또는, 비즈니스 관리자의 관리자 시스템 사용자를 만들었다면 해당 사용자의 액세스 토큰을 사용하여 시스템 사용자를 만듭니다.

시스템 사용자의 액세스 토큰 생성

1. 관리자 사용자, 관리자 시스템 사용자 또는 다른 시스템 사용자의 액세스 토큰을 사용하여 시스템 사용자로 앱을 설치합니다.
2. 비즈니스 관리자에 속한 자산(예: 광고 계정, 페이지)에 권한을 할당합니다. 권한은 액세스 토큰을 사용하여 새로 생성한 시스템 사용자(관리자 사용자 또는 관리자 시스템 사용자)에게 할당해야 합니다.
3. 관리자 사용자 또는 관리자 시스템 사용자의 액세스 토큰을 사용하여 시스템 사용자 액세스 토큰을 생성합니다.
4. 이제 시스템 사용자 액세스 토큰을 사용하여 비즈니스 자산에 대해 API 호출을 보냅니다.

API를 통해 시스템 사용자 또는 관리자 시스템 사용자를 만들기 위해서는 다음이 필요합니다.

• 이 비즈니스 관리자에 대한 관리자 사용자 또는 관리자 시스템 사용자의 액세스 토큰
• 역할: ADMIN 또는 EMPLOYEE
• 이름: 이 시스템 사용자 또는 관리자 시스템 사용자의 식별자

시스템 사용자를 만들려면 다음과 같이 POST 요청을 보냅니다.

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

그러면 새로운 시스템 사용자의 앱 범위 id가 반환됩니다.

{
  "id" : "100000008899900"
}

이는 시스템 사용자의 앱 범위 ID입니다. API 호출을 보내려면 Business Manager > System Users의 표준 ID가 아니라 이 ID를 사용해야 합니다.

검색

시스템 사용자의 리스트를 가져오려면 관리자 사용자 또는 관리자 시스템 사용자 액세스 토큰이 필요합니다. 이 리스트에는 관리자 시스템 사용자와 앱 범위 ID가 필요합니다.

다음과 같이 GET 요청을 보냅니다.

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

그러면 비즈니스 관리자가 소유한 관리자 시스템 사용자를 포함한 모든 시스템 사용자의 리스트가 반환됩니다.

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

업데이트

시스템 사용자 또는 관리자 시스템 사용자의 이름을 변경할 수 있습니다.

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

액세스 토큰 무효화

시스템 사용자 또는 관리자 시스템 사용자를 삭제할 수 없지만 해당 사용자의 모든 액세스 토큰을 무효화할 수 있는 있습니다. 다음으로 DELETE 요청을 보내서 토큰을 무효화합니다.

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

호출이 성공하면 응답에서 true를 반환합니다. 그 이후에는 위와 같이 이 시스템 사용자에 대한 새 액세스 토큰을 생성할 수 있습니다.