图谱 API 版

Image Copyright

读取

Represents a copyright on an image asset.

例子

GET /v21.0/{image-copyright-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(
    '/{image-copyright-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(
    "/{image-copyright-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{image-copyright-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:@"/{image-copyright-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

如果你希望详细了解如何使用图谱 API，请阅读我们的图谱 API 指南。

参数

这个端点不包含任何参数。

字段

字段	描述
`id` numeric string	The id of the object
`artist` string	Artist/Photographer related the reference asset, user providedNote that the "Creator" field is used for image agencies or partners.
`copyright_monitoring_status` enum	The status of the copyright reference file. It is used to determine if the match should be skipped.
`creation_time` datetime	Creation time provided by TAO Server
`creator` string	Creator of the reference asset, user provided
`custom_id` string	Custom Id for reference asset, user provided
`description` string	Description for reference asset, user provided
`filename` string	Filename for reference asset, user provided
`image` Photo	The underlying image asset for the copyright
`matches_count` unsigned integer	The number of matches for this copyright that are displayed in Rights Manager
`original_content_creation_date` datetime	Date the reference asset was created, user provided
`ownership_countries` VideoCopyrightGeoGate	Countries of included or excluded ownership for the given image copyright
`tags` list<string>	Tags for the reference asset
`title` string	The title of the copyright, generated from the reference asset
`update_time` datetime	Update time provided by TAO Server

错误代码

错误	描述
368	The action attempted has been deemed abusive or is otherwise disallowed

创建

你可以通过下列路径向 image_copyrights 连线发出 POST 请求：

/{page_id}/image_copyrights

发布到这个连线会创建 an ImageCopyright 。

参数

参数	描述
`artist` string	Artist/Photographer related to the copyright
`attribution_link` string	The link to the rights holder where viewer can license the images.
`creator` string	For agencies
`custom_id` string	Any ID used internally by the copyright holder
`description` string	Description of the copyrighted image
`filename` string	Filename of the copyrighted image 必填
`geo_ownership` list<enum {AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TP, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW}>	In which territories the copyright on the image is held 必填
`original_content_creation_date` int64	When the copyrighted image was created
`reference_photo` numeric string or integer	ID of the uploaded image to be protected. This must be an unpublished, temporary photo. Please refer to the photo documentation on how to create unpublished, temporary photos. 必填
`title` string	Title of the copyrighted image

返回类型

这个端点支持先写后读，并会读取返回类型中 id 代表的节点。

Struct {

id: numeric string,

}

错误代码

错误	描述
100	Invalid parameter

更新

你可以向 /{image_copyright_id} 发出 POST 请求，以更新 an ImageCopyright 。

参数

参数	描述
`artist` string	Artist/Photographer related to the copyright
`creator` string	For agencies
`description` string	Description of the copyrighted image
`geo_ownership` list<enum {AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TP, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW}>	In which territories the copyright on the image is held
`original_content_creation_date` int64	When the copyrighted image was created
`title` string	Title of the copyrighted image

返回类型

这个端点支持先写后读，并会读取接收你的 POST 请求的节点。

Struct {

success: bool,

}

删除

你无法在此端点执行该操作。