Graph 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
}];

如果想了解如何使用 Graph API，請參閱我們的使用 Graph 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

Error Codes

錯誤	說明
368	The action attempted has been deemed abusive or is otherwise disallowed

建立中

You can make a POST request to image_copyrights edge from the following paths:

/{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,

}

Error Codes

錯誤	說明
100	Invalid parameter

更新中

You can update an ImageCopyright by making a POST request to /{image_copyright_id}.

參數

參數	描述
`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

傳回類型

This endpoint supports 寫入後讀取 and will read the node to which you POSTed.

Struct {

success: bool,

}

正在刪除

你無法在此端點執行此操作。