curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}
Facebook Ads
تحديث إعلان
تحديث إعلان
PUT
/
ads
/
facebook
/
ads
curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}
حدّث حالة إعلان مُعزَّز لجعله نشطًا أو موقوفًا مؤقتًا أو محذوفًا أو مؤرشفًا.
- بالنسبة إلى تعزيز أُضيف إلى حملتك أو مجموعة إعلاناتك الخاصة باستخدام
attachTo، تُطبَّق الحالة الجديدة فقط على ما أنشأه التعزيز: الإعلان، ومجموعة الإعلانات إذا كان التعزيز هو من أنشأها. تحتفظ الحملة أو مجموعة الإعلانات التي حددتها فيattachToبحالتها الخاصة. لا يعمل الإعلان إلا عندما تكون الحملة ومجموعة الإعلانات اللتان تعلوانه نشطتين. راجع التعزيز ضمن حملة أو مجموعة إعلانات موجودة. - يمكن إيقاف إعلان لا يوجد لدى Ayrshare سجل له مؤقتًا أو حذفه أو أرشفته، لكن لا يمكن ضبطه على
active. يُرجع هذا الطلب400. تواصل مع الدعم مع ذكر معرّف الإعلان.
معاملات الترويسة
معاملات الجسم
string
مطلوب
معرّف الإعلان المُعزَّز المراد تحديثه.
string
مطلوب
حالة الإعلان. القيم:
active أو paused أو deleted أو archived.curl \
-H "Authorization: Bearer API_KEY" \
-X PUT https://api.ayrshare.com/api/ads/facebook/ads
-d '{"adId": 1234567890, "status": "active"}'
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/ads", {
method: "PUT",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({ adId: 1234567890, status: "active" })
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
r = requests.put('https://api.ayrshare.com/api/ads/facebook/ads', headers=headers, json={"adId": 1234567890, "status": "active"})
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/ads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode(["adId" => 1234567890, "status" => "active"])
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.PutAsync("https://api.ayrshare.com/api/ads/facebook/ads", new StringContent(JsonConvert.SerializeObject(new { adId = 1234567890, status = "active" }), Encoding.UTF8, "application/json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/ads/facebook/ads", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/ads"))
.header("Authorization", "Bearer API_KEY")
.PUT(HttpRequest.BodyPublishers.ofString(Json.stringify(new { adId = 1234567890, status = "active" })))
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/facebook/ads')
request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer API_KEY'
request.body = JSON.generate({ adId: 1234567890, status: "active" })
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"adId": "6691084804905",
"requestedStatus": "ACTIVE"
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "Invalid status: actives. Status must be either 'active', 'paused', 'deleted', or 'archived'."
}