グラフAPIバージョン

Facebook App

A Facebook app.

読み取り

Get information about a Facebook app.

Permissions

  • An app access token can be used to view all fields for an app.

例

Graph API Explorer 
GET /v24.0/{application-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
 // Returns a `Facebook\FacebookResponse` object
 $response = $fb->get(
 '/{application-id}',
 '{access-token}'
 );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
 echo 'Graph returned an error: ' . $e->getMessage();
 exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
 echo 'Facebook SDK returned an error: ' . $e->getMessage();
 exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
 "/{application-id}",
 function (response) {
 if (response && !response.error) {
 /* handle the result */
 }
 }
);
/* make the API call */
new GraphRequest(
 AccessToken.getCurrentAccessToken(),
 "/{application-id}",
 null,
 HttpMethod.GET,
 new GraphRequest.Callback() {
 public void onCompleted(GraphResponse response) {
 /* handle the result */
 }
 }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
 initWithGraphPath:@"/{application-id}"
 parameters:params
 HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
 id result,
 NSError *error) {
 // Handle the result
}];
グラフAPIを使用する方法については、グラフAPIの使用ガイドをご覧ください。

パラメーター

このエンドポイントにはパラメーターがありません。

フィールド

フィールド説明
id
numeric string

The app ID

aam_rules
string

Rules of Auto Advanced Matching in FB SDKs

an_ad_space_limit
unsigned int32

The maximum number of Ad Spaces allowed for each Audience Network supported platform

an_platforms
list<enum>

The platforms associated with the app in the Audience Network product. Not enforced, but when present, it can be used to provide the user with platform specific information for the app and its placements

app_domains
list<string>

Domains and subdomains this app can use

app_events_config
ApplicationAppEventsConfig

Configuration for app events

app_install_tracked
bool

Whether the app install is trackable or not

app_name
string

App name

app_signals_binding_ios
list<Binding>

List of app event bindings for iOS app

app_type
unsigned int32

App type

auth_dialog_data_help_url
string

The URL of a special landing page that helps people who are using an app begin publishing Open Graph activity

auth_dialog_headline
string

One line description of an app that appears in the Login Dialog

auth_dialog_perms_explanation
string

The text to explain why an app needs additional permissions. This appears in the Login Dialog

auth_referral_default_activity_privacy
string

The default privacy setting selected for Open Graph activities in the Auth Dialog

auth_referral_enabled
unsigned int32

Indicates whether Authenticated Referrals are enabled

auth_referral_extended_perms
list<string>

Extended permissions that a person can choose to grant when Authenticated Referrals are enabled

auth_referral_friend_perms
list<string>

Basic friends permissions that a user must grant when Authenticated Referrals are enabled

auth_referral_response_type
string

The format that an app receives for the authentication token from the Login Dialog

auth_referral_user_perms
list<string>

Basic user permissions that a user must grant when Authenticated Referrals are enabled

canvas_fluid_height
bool

Indicates whether the app uses fluid or settable height values for Canvas

canvas_fluid_width
unsigned int32

Indicates whether the app uses fluid or fixed width values for Canvas

canvas_url
string

The non-secure URL from which Canvas app content is loaded

category
string

The category of the app

client_config
map

Config data for the client

company
string

The company the app belongs to

configured_ios_sso
bool

True if the app has configured Single Sign On on iOS

contact_email
string

Email address listed for people using the app to contact developers

created_time
datetime

Timestamp that indicates when the app was created

creator_uid
id

User ID of the creator of this app

daily_active_users
numeric string

The number of daily active users the app has

daily_active_users_rank
unsigned int32

Ranking of this app vs other apps comparing daily active users

deauth_callback_url
string

URL that is pinged whenever a person removes the app

default_share_mode
string

The platform that should be used to share content

description
string

The description of the app, as provided by the developer

financial_id
string

The ID for the corresponding audience network financial entity.

hosting_url
string

Webspace created with one of our hosting partners for this app

icon_url
string

The URL of this app's icon

ios_bundle_id
list<string>

Bundle ID of the associated iOS app

ios_supports_native_proxy_auth_flow
bool

Whether to support the native proxy login flow

ios_supports_system_auth
bool

Whether to support the iOS integrated Login Dialog

ipad_app_store_id
string

ID of the app in the iPad App Store

iphone_app_store_id
string

ID of the app in the iPhone App Store

latest_sdk_version
ApplicationSDKInfo

App latest sdk version

link
string

A link to the app on Facebook

logging_token
string

To use for logging purposes

logo_url
string

The URL of the app's logo

migrations
map<string, bool>

Status of migrations for this app

mobile_profile_section_url
string

Mobile URL of the app section on a person's profile

mobile_web_url
string

URL to which Mobile users will be directed when using the app

monthly_active_users
numeric string

The number of monthly active users the app has

monthly_active_users_rank
unsigned int32

Ranking of this app vs other apps comparing monthly active users

name
string

The name of the app

namespace
string

The string appended to apps.facebook.com/ to navigate to the app's canvas page

object_store_urls

Mobile store URLs for the app

page_tab_default_name
string

The title of the app when used in a Page Tab

page_tab_url
string

The non-secure URL from which Page Tab app content is loaded

photo_url
string

The URL of the app photo

privacy_policy_url
string

The URL that links to a Privacy Policy for the app

profile_section_url
string

URL of the app section on a user's profile for the desktop site

property_id
string

The monetization property which owns this app

protected_mode_rules
ApplicationProtectedModeRules

protected_mode_rules

real_time_mode_devices
list<string>

List of real time hashed device

restrictions

Demographic restrictions for the app

restrictive_data_filter_params
string

Params used to filter out restrictive data

secure_canvas_url
string

The secure URL from which Canvas app content is loaded

secure_page_tab_url
string

The secure URL from which Page Tab app content is loaded

server_ip_whitelist
string

App requests must originate from this comma-separated list of IP addresses

social_discovery
unsigned int32

Indicates whether app usage stories show up in the Ticker or Feed

subcategory
string

The subcategory the app can be found under

suggested_events_setting
string

Settings for suggested events

supported_platforms
list<enum {WEB, CANVAS, MOBILE_WEB, IPHONE, IPAD, ANDROID, WINDOWS, AMAZON, SUPPLEMENTARY_IMAGES, GAMEROOM, INSTANT_GAME, OCULUS, SAMSUNG, XIAOMI}>

All the platform the app supports

terms_of_service_url
string

URL to Terms of Service that appears in the Login Dialog

url_scheme_suffix
string

URL scheme suffix

user_support_email
string

Main contact email for this app where people can receive support

user_support_url
string

URL shown in the Canvas footer that people can visit to get support for the app

website_url
string

URL of a website that integrates with this app

weekly_active_users
numeric string

The number of weekly active users the app has

エッジ

エッジ説明
Edge<TestAccount>

Test User accounts associated with the app

Edge<AdPlacementGroup>

Ad placement groups for publishing ads on this app

Edge<AdNetworkAnalyticsAsyncQueryResult>

Obtain the results of an async Audience Network query for this publisher entity

Edge<AEMAttribution>

aem_attribution

Edge<AEMConversionConfig>

The aggregated event measurement conversion value configs for this app

Edge<AEMConversionFilter>

Boolean for if product_set_id [fb_content_id] belongs to a certain catalog [catalog_id]

Edge<Business>

The businesses which are not owner but can advertise for this app

Edge<ApplicationAppEventTypes>

Info about App Events logged for the app

Edge<Group>

List of facebook groups the app is installed in

Edge<CanvasAppAsset>

appassets

Edge<ButtonAutoDetectionDeviceSelection>

Whether to turn on auto device sampling.

Edge<CloudbridgeSetting>

cloudbridge_settings

Edge<Business>

connected_client_businesses

Edge<DACheck>

A list of results after running Dynamic Ads checks on this app.

Edge<ConversionConfig>

ios_skadnetwork_conversion_config

Edge<MobileSdkGk>

Gatekeeper for Mobile SDK

Edge<SDKMLModel>

model_asset

Edge<MonetizedDigitalStoreObject>

List of digital store objects for this app monetized via Audience Network

Edge<Null>

Open Graph Object types associated with this app

Edge<Null>

Open Graph objects

Edge<ApplicationPermission>

The status of permissions that are have been submitted for Login Review

Edge<GamesIAPProduct>

In-app-purchaseable products associated with this app

Edge<GamesIAPOrder>

In-app-purchaseable products of this app owned by the user

Edge<ApplicationRoles>

The developer roles defined for this app

Edge<ApplicationSgwDatasetStatus>

sgw_dataset_status

Edge<ApplicationSgwInstallDeferralLink>

sgw_install_deferral_link

Edge<ThreatPrivacyGroup>

The privacy groups of which this app is the member

Edge<ThreatPrivacyGroup>

The privacy groups of which this app is the owner

Edge<WhatsAppBusinessSolution>

Lists the WhatsApp Business Partner Solution objects that the application participate in.

エラーコード

エラー詳細
100Invalid parameter
190Invalid OAuth 2.0 Access Token
459The session is invalid because the user has been checkpointed
368The action attempted has been deemed abusive or is otherwise disallowed
200Permissions error
105The number of parameters exceeded the maximum for this operation
3000Reading insights of a Page, business, app, domain or event source group not owned by the querying user or application
483The session is invalid because the user is in consent app blocking
2500Error parsing graph query
104Incorrect signature

作成

owned_appsのエッジにPOSTリクエストを以下のパスで送信できます:
このエッジにPOSTする場合、an Applicationが作成されます。

パラメーター

このエンドポイントにはパラメーターがありません。

戻り値の型

This endpoint supports read-after-write and will read the node to which you POSTed.
Struct {
access_status: string,
}

エラーコード

エラー詳細
200Permissions error
app_indexingのエッジにPOSTリクエストを以下のパスで送信できます:
このエッジにPOSTする場合、an Applicationが作成されます。

パラメーター

パラメーター説明
app_version
string

The version of the app being indexed

必須
device_session_id
string

Device session id of the uploading device

extra_info
string

Extra information about the app index

platform
enum {ANDROID, IOS}

The platform of the app being indexed

必須
request_type
enum {APP_INDEXING, PLUGIN, BUTTON_SAMPLING}
デフォルト値: "APP_INDEXING"

Type of the app indexing request

tree
JSON object

The UI component tree of the app

必須
screenname
string

screenshot
string

view
list<JSON encoded app UI component>

必須

戻り値の型

Struct {
success: bool,
is_app_indexing_enabled: bool,
}

エラーコード

エラー詳細
100Invalid parameter
codeless_event_mappingsのエッジにPOSTリクエストを以下のパスで送信できます:
このエッジにPOSTする場合、an Applicationが作成されます。

パラメーター

パラメーター説明
mappings
array<JSON object>

The event to UI component mappings of the app

必須
method
enum {INFERENCE, MANUAL, CONFIRMED_INFERENCE, BUTTON_INDEXING, UNKNOWN}

method

必須
event_name
string

event_name

必須
event_type
enum {CLICK, SELECTED, TEXT_CHANGED}

event_type

必須
app_version
string

app_version

必須
parameters
array<JSON object>

parameters

name
string

name

必須
path
array<JSON object>

path

必須
class_name
string

class_name

必須
index
int64

index

必須
id
int64

id

text
string

text

tag
string

tag

description
string

description

hint
string

hint

match_bitmask
int64

match_bitmask

path_type
enum {ABSOLUTE, RELATIVE}
デフォルト値: "ABSOLUTE"

path_type

component_id
string

component_id

必須
path
array<JSON object>

path

必須
class_name
string

class_name

必須
index
int64

index

必須
id
int64

id

text
string

text

tag
string

tag

description
string

description

hint
string

hint

match_bitmask
int64

match_bitmask

component_id
string

component_id

必須
path_type
enum {ABSOLUTE, RELATIVE}
デフォルト値: "ABSOLUTE"

path_type

screenshot_handle
string

screenshot_handle

dimensions
array<JSON object>

dimensions

top
int64

top

必須
left
int64

left

必須
width
int64

width

必須
height
int64

height

必須
activity_name
string

activity_name

mutation_method
enum {REPLACE, ADD, DELETE}

Detailed mutation type like replace, add

必須
platform
enum {ANDROID, IOS}

The platform of the app being indexed

必須
post_method
enum {EYMT, CODELESS}
デフォルト値: "CODELESS"

Whether the api is called by codeless or EYMT

戻り値の型

Struct {
num_updated: int32,
num_invalid: int32,
}

エラーコード

エラー詳細
105The number of parameters exceeded the maximum for this operation
client_appsのエッジにPOSTリクエストを以下のパスで送信できます:
このエッジにPOSTする場合、an Applicationが作成されます。

パラメーター

パラメーター説明
app_id

App ID.

必須

戻り値の型

This endpoint supports read-after-write and will read the node to which you POSTed.
Struct {
access_status: enum,
}

エラーコード

エラー詳細
100Invalid parameter

更新中...

Update application information such as demographic restrictions.

Permissions

  • An app access token is required to update fields on an app.

Example

To update an app restrictions, such as age, send a POST request to /{app-id}:

curl -i -X POST "https://graph.facebook.com/{app-id}?restrictions={'age':'21+'}&access_token={app-access-token}"

On success your app receives this response:

{ "success": true }

/{application_id}にPOSTリクエストを送信してan Applicationを更新できます。

パラメーター

パラメーター説明
allow_cycle_app_secret
boolean
デフォルト値: false

Allows for the application to cycle the secret

an_platforms
list<enum {ANDROID, DESKTOP, GALAXY, INSTANT_ARTICLES, IOS, MOBILE_WEB, OCULUS, UNKNOWN, XIAOMI}>

The platforms associated with the app in the AudienceNetwork product

app_domains
list<string>

Specifies a list of domains that correspond to this app. Subdomains of domains in this array are also considered to belong to this app

app_name
string

App name

app_type
boolean

App type

auth_dialog_headline
string

One line description of this app that appears in the Login Dialog

auth_dialog_perms_explanation
string

The text to explain why an app needs additional permissions. This appears in the Login Dialog

auth_referral_enabled
boolean

Enables or disables Authenticated Referrals

auth_referral_extended_perms
list<string>

Extended permissions that a person can choose to grant when Authenticated Referrals are enabled

auth_referral_friend_perms
list<string>

Basic friends permissions that a person must grant when Authenticated Referrals are enabled

auth_referral_response_type
string

The format of the authentication token this app receives from the Login Dialog

auth_referral_user_perms
list<string>

Basic permissions that a person must grant when Authenticated Referrals are enabled

canvas_fluid_height
boolean

Indicates whether this app uses fluid or settable height values for Canvas

canvas_fluid_width
boolean

Indicates whether this app uses fluid or fixed width values for Canvas

canvas_url
URL

The non-secure URL from which Canvas app content is loaded

contact_email
string

Email address users can use to contact developers

deauth_callback_url
URL

URL that is pinged whenever a person removes this app

mobile_web_url
URL

URL that mobile users will be directed to when using this app

namespace
string

The string appended to apps.facebook.com/ to navigate to this app's Canvas page

page_tab_default_name
string

The title of this app as it appears in a Page Tab

privacy_policy_url
URL

The URL that links to a privacy policy for this app

restrictions
JSON-encoded string

Update demographic restrictions for this app. Can be one or more of the following parameters: age, location, or type. age can be one of the following values: 13+, 16+, 17+, 18+, 19+, or 21+. location can be one or more country represented by the 2 letter country code. type can only be alcohol.

secure_canvas_url
URL

The secure URL from which Canvas app content is loaded

secure_page_tab_url
URL

The secure URL from which Page Tab app content is loaded

server_ip_whitelist
list<string>

App requests must originate from this comma-separated list of IP addresses

terms_of_service_url
URL

URL to Terms of Service that appears in the Login Dialog

url_scheme_suffix
string

URL scheme suffix

user_support_email
string

Main contact email for this app where people can receive support

user_support_url
URL

URL shown in the Canvas footer that people can visit to get support for this app

website_url
URL

URL of a website that integrates with this app

戻り値の型

This endpoint supports read-after-write and will read the node to which you POSTed.
Struct {
success: bool,
}

エラーコード

エラー詳細
100Invalid parameter
104Incorrect signature
368The action attempted has been deemed abusive or is otherwise disallowed
/act_{ad_account_id}/subscribed_appsにPOSTリクエストを送信してan Applicationを更新できます。

パラメーター

パラメーター説明
app_id
string
デフォルト値:

the id of app to be subscribed from ad account

戻り値の型

このエンドポイントはリード‐アフター‐ライトに対応し、idによって表されたノードを戻り値の型で読み込みます。
Struct {
success: bool,
}

エラーコード

エラー詳細
100Invalid parameter
200Permissions error
/{application_id}/mmp_auditingにPOSTリクエストを送信してan Applicationを更新できます。

パラメーター

パラメーター説明
advertiser_id
string

Apple's Identifier for Advertisers (IDFA) or Android's Advertising ID. You can see how Facebook fetches this on iOS or on Android

attribution
string

mobile_cookie from the person's device. Use this only on Android or iOS devices before iOS 6. The format for this should be like DDDECD0A-C076-4050-8CE8-C20EC3FC2BD3

attribution_method
string

The attribution method used. The options are: {ARD, DEEPLINK, GPIR, MIR, SRN}

attribution_model
string

The attribution model that the client selected to be respected by MMP

attribution_referrer
string

The attribution referrer, if one was used

auditing_token
string

The token provided in claim response sent to MMP

click_attr_window
int64

Time window of click attribution

custom_events
list<CustomEvent>

When the event_type is custom_app_events, custom_events should contain the names of the custom events.

_eventName
RegexParam

Event name, must match the regular expression /^[0-9a-zA-Z_][0-9a-zA-Z _-]{0,39}$/

必須
_eventName_md5
RegexParam

MD5 hash of the event name, must match the regular expression /^[A-Fa-f0-9]{32}$/

_valueToSum
float

Values to Sum

_logTime
int64

Time to Log

_implicitlyLogged
int64

Whether this is implicitly logged

_isTimedEvent
boolean

Whether this is a timed event

_session_id
string

_app_user_id
string

decline_reason
string

The reason that the MMP rejected Meta's claim

device_os
string

The OS of the device the event was on

engagement_type
string

The engagement type from Meta's claim, such as engaged_view

event
string

Event type that Facebook claimed for

必須
event_id
string

An MMP-defined event ID, unique for each event

event_reported_time
int64

The time at which the event was reported to MMP

fb_ad_id
int64

FBID of the ad in Meta's claim

fb_adgroup_id
int64

FBID of the adgroup. Provide this parameter when the attribution method is ARD (auto-redirect).

fb_click_time
int64

Ad click time in Meta claim

fb_view_time
int64

Ad view time in Meta claim

google_install_referrer
string

The raw GPIR referrer string, if this event was attributed by GPIR

inactivity_window_hours
int64

Inactivity window in hours

install_id
string

If this is an install event, install_id should be an MMP-generated ID unique across all installs (which can be the same as the event_id). If this is a post-install event, the install_id should be MMP-defined install_id of the install event that preceded this event.

is_fb
boolean

Result (whether the MMP attributed the event to Meta ads)

必須
meta_install_referrer
string

The raw MIR referrer string, if this event was attributed by MIR

used_install_referrer
boolean

Identifies whether MMP used the install referrer

view_attr_window
int64

Time window of view attribution

戻り値の型

Struct {
success: bool,
} または Struct {
success: bool,
}

エラーコード

エラー詳細
100Invalid parameter

削除中です

You can dissociate an Application from a Page by making a DELETE request to /{page_id}/subscribed_apps.

パラメーター

このエンドポイントにはパラメーターがありません。

戻り値の型

Struct {
success: bool,
messaging_success: bool,
}

エラーコード

エラー詳細
100Invalid parameter
190Invalid OAuth 2.0 Access Token
210User not visible
200Permissions error
104Incorrect signature
You can dissociate an Application from an AdAccount by making a DELETE request to /act_{ad_account_id}/subscribed_apps.

パラメーター

パラメーター説明
app_id
string
デフォルト値:

the id of app to be unsubscribed from ad account

戻り値の型

Struct {
success: bool,
}

エラーコード

エラー詳細
100Invalid parameter

AltStyle によって変換されたページ (->オリジナル) /