更新使用者
curl --request PATCH \
--url https://api.ayrshare.com/api/user/:platform \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumbers": {},
"name": "<string>",
"adPhone": "<string>",
"storeCode": "<string>",
"title": "<string>",
"websiteUrl": "<string>",
"labels": [
{}
],
"latlng": {},
"profile": {},
"about": "<string>",
"description": "<string>",
"address": "<string>",
"email": "<string>",
"websites": [
{}
],
"vertical": "<string>",
"profilePictureUrl": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phoneNumbers: {},
name: '<string>',
adPhone: '<string>',
storeCode: '<string>',
title: '<string>',
websiteUrl: '<string>',
labels: [{}],
latlng: {},
profile: {},
about: '<string>',
description: '<string>',
address: '<string>',
email: '<string>',
websites: [{}],
vertical: '<string>',
profilePictureUrl: '<string>'
})
};
fetch('https://api.ayrshare.com/api/user/:platform', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/user/:platform"
payload = {
"phoneNumbers": {},
"name": "<string>",
"adPhone": "<string>",
"storeCode": "<string>",
"title": "<string>",
"websiteUrl": "<string>",
"labels": [{}],
"latlng": {},
"profile": {},
"about": "<string>",
"description": "<string>",
"address": "<string>",
"email": "<string>",
"websites": [{}],
"vertical": "<string>",
"profilePictureUrl": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/user/:platform",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'phoneNumbers' => [
],
'name' => '<string>',
'adPhone' => '<string>',
'storeCode' => '<string>',
'title' => '<string>',
'websiteUrl' => '<string>',
'labels' => [
[
]
],
'latlng' => [
],
'profile' => [
],
'about' => '<string>',
'description' => '<string>',
'address' => '<string>',
'email' => '<string>',
'websites' => [
[
]
],
'vertical' => '<string>',
'profilePictureUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/user/:platform"
payload := strings.NewReader("{\n \"phoneNumbers\": {},\n \"name\": \"<string>\",\n \"adPhone\": \"<string>\",\n \"storeCode\": \"<string>\",\n \"title\": \"<string>\",\n \"websiteUrl\": \"<string>\",\n \"labels\": [\n {}\n ],\n \"latlng\": {},\n \"profile\": {},\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"address\": \"<string>\",\n \"email\": \"<string>\",\n \"websites\": [\n {}\n ],\n \"vertical\": \"<string>\",\n \"profilePictureUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.ayrshare.com/api/user/:platform")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"phoneNumbers\": {},\n \"name\": \"<string>\",\n \"adPhone\": \"<string>\",\n \"storeCode\": \"<string>\",\n \"title\": \"<string>\",\n \"websiteUrl\": \"<string>\",\n \"labels\": [\n {}\n ],\n \"latlng\": {},\n \"profile\": {},\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"address\": \"<string>\",\n \"email\": \"<string>\",\n \"websites\": [\n {}\n ],\n \"vertical\": \"<string>\",\n \"profilePictureUrl\": \"<string>\"\n}")
.asString();{
"gmb": {
"status": "success",
"data": {
"name": "locations/4913369732395328466",
"languageCode": "en",
"title": "Ayrshare",
"phoneNumbers": {},
"categories": {
"primaryCategory": {
"name": "categories/gcid:software_company",
"displayName": "Software company",
"serviceTypes": [
{
"serviceTypeId": "job_type_id:application_development",
"displayName": "Application development"
},
{
"serviceTypeId": "job_type_id:big_data_consulting_and_implementation",
"displayName": "Big data consulting & implementation"
},
{
"serviceTypeId": "job_type_id:data_center_management",
"displayName": "Data center management"
},
{
"serviceTypeId": "job_type_id:data_quality_management",
"displayName": "Data quality management"
},
{
"serviceTypeId": "job_type_id:enterprise_software_development",
"displayName": "Enterprise software development"
},
{
"serviceTypeId": "job_type_id:it_consulting",
"displayName": "It consulting"
},
{
"serviceTypeId": "job_type_id:mobile_app_development",
"displayName": "Mobile app development"
},
{
"serviceTypeId": "job_type_id:platform_consulting",
"displayName": "Platform consulting"
},
{
"serviceTypeId": "job_type_id:security_services_management",
"displayName": "Security services management"
},
{
"serviceTypeId": "job_type_id:software_consulting",
"displayName": "Software consulting"
},
{
"serviceTypeId": "job_type_id:software_development",
"displayName": "Software development"
},
{
"serviceTypeId": "job_type_id:software_development_outsourcing",
"displayName": "Software development outsourcing"
},
{
"serviceTypeId": "job_type_id:solution_consulting",
"displayName": "Solution consulting"
}
],
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
},
"additionalCategories": [
{
"name": "categories/gcid:automation_company",
"displayName": "Automation company",
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
}
]
},
"storefrontAddress": {
"regionCode": "US",
"languageCode": "en",
"postalCode": "10019",
"administrativeArea": "NY",
"locality": "New York",
"addressLines": [
"142 W 57th St"
]
},
"websiteUri": "https://www.ayrshare.com/",
"regularHours": {
"periods": [
{
"openDay": "SUNDAY",
"openTime": {},
"closeDay": "SUNDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "MONDAY",
"openTime": {},
"closeDay": "MONDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "TUESDAY",
"openTime": {},
"closeDay": "TUESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "WEDNESDAY",
"openTime": {},
"closeDay": "WEDNESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "THURSDAY",
"openTime": {},
"closeDay": "THURSDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "FRIDAY",
"openTime": {},
"closeDay": "FRIDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "SATURDAY",
"openTime": {},
"closeDay": "SATURDAY",
"closeTime": {
"hours": 24
}
}
]
},
"serviceArea": {
"businessType": "CUSTOMER_AND_BUSINESS_LOCATION",
"places": {
"placeInfos": [
{
"placeName": "United States",
"placeId": "ChIJCzYy5IS16lQRQrfeQ5K5Oxw"
}
]
},
"regionCode": "US"
},
"openInfo": {
"status": "OPEN",
"canReopen": true
},
"metadata": {
"hasPendingEdits": true,
"canDelete": true,
"canModifyServiceList": true,
"placeId": "ChIJN53jw8BZwokRBEeVVtPLkkg",
"mapsUri": "https://maps.google.com/maps?cid=5229466225881728772",
"newReviewUri": "https://search.google.com/local/writereview?placeid=ChIJN53jw8BZwokRBEeVVtPLkkg",
"hasVoiceOfMerchant": true
},
"profile": {
"description": "Easy to integrate Social Media APIs allow you to manage all your users' social accounts right from your product. Post, Auto Schedule, and Analytics. Great for SaaS, CMS, DAM, Agencies, and Apps."
}
}
}
}
{
"action": "authorization",
"status": "error",
"code": 227,
"message": "Error updating GBP location data. This can occur if you attempt more than 5 updates within a rolling 24 hours period. Please wait and try again."
}
{
"whatsapp": {
"status": "success",
"data": {
"messaging_product": "whatsapp",
"about": "Open 9am-6pm",
"description": "Bike shop since 1998",
"address": "123 Example St, Springfield",
"email": "hello@example.com",
"websites": ["https://example.com"],
"vertical": "RETAIL",
"profile_picture_url": "https://scontent.whatsapp.net/..."
}
}
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "`about` must be 139 characters or fewer (received 150)."
}
{
"action": "post",
"status": "error",
"code": 156,
"message": "whatsapp is not linked. Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/dashboard/connect-social-accounts/overview"
}
{
"action": "request",
"status": "error",
"code": 472,
"message": "This feature is not yet available on your account. Please contact us if you'd like early access."
}
{
"action": "rate limit",
"status": "error",
"code": 364,
"message": "You are making too many requests. Please reduce the number of requests.",
"details": "Meta rejected the WhatsApp profile request."
}
{
"action": "authorization",
"status": "error",
"code": 141,
"message": "There was an issue connecting. Please try linking the social account again.",
"details": "Network error updating the WhatsApp business profile."
}
User
更新使用者
更新社群網路的帳號或使用者資料
PATCH
/
user
/
:platform
更新使用者
curl --request PATCH \
--url https://api.ayrshare.com/api/user/:platform \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phoneNumbers": {},
"name": "<string>",
"adPhone": "<string>",
"storeCode": "<string>",
"title": "<string>",
"websiteUrl": "<string>",
"labels": [
{}
],
"latlng": {},
"profile": {},
"about": "<string>",
"description": "<string>",
"address": "<string>",
"email": "<string>",
"websites": [
{}
],
"vertical": "<string>",
"profilePictureUrl": "<string>"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phoneNumbers: {},
name: '<string>',
adPhone: '<string>',
storeCode: '<string>',
title: '<string>',
websiteUrl: '<string>',
labels: [{}],
latlng: {},
profile: {},
about: '<string>',
description: '<string>',
address: '<string>',
email: '<string>',
websites: [{}],
vertical: '<string>',
profilePictureUrl: '<string>'
})
};
fetch('https://api.ayrshare.com/api/user/:platform', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/user/:platform"
payload = {
"phoneNumbers": {},
"name": "<string>",
"adPhone": "<string>",
"storeCode": "<string>",
"title": "<string>",
"websiteUrl": "<string>",
"labels": [{}],
"latlng": {},
"profile": {},
"about": "<string>",
"description": "<string>",
"address": "<string>",
"email": "<string>",
"websites": [{}],
"vertical": "<string>",
"profilePictureUrl": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/user/:platform",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'phoneNumbers' => [
],
'name' => '<string>',
'adPhone' => '<string>',
'storeCode' => '<string>',
'title' => '<string>',
'websiteUrl' => '<string>',
'labels' => [
[
]
],
'latlng' => [
],
'profile' => [
],
'about' => '<string>',
'description' => '<string>',
'address' => '<string>',
'email' => '<string>',
'websites' => [
[
]
],
'vertical' => '<string>',
'profilePictureUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/user/:platform"
payload := strings.NewReader("{\n \"phoneNumbers\": {},\n \"name\": \"<string>\",\n \"adPhone\": \"<string>\",\n \"storeCode\": \"<string>\",\n \"title\": \"<string>\",\n \"websiteUrl\": \"<string>\",\n \"labels\": [\n {}\n ],\n \"latlng\": {},\n \"profile\": {},\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"address\": \"<string>\",\n \"email\": \"<string>\",\n \"websites\": [\n {}\n ],\n \"vertical\": \"<string>\",\n \"profilePictureUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.ayrshare.com/api/user/:platform")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"phoneNumbers\": {},\n \"name\": \"<string>\",\n \"adPhone\": \"<string>\",\n \"storeCode\": \"<string>\",\n \"title\": \"<string>\",\n \"websiteUrl\": \"<string>\",\n \"labels\": [\n {}\n ],\n \"latlng\": {},\n \"profile\": {},\n \"about\": \"<string>\",\n \"description\": \"<string>\",\n \"address\": \"<string>\",\n \"email\": \"<string>\",\n \"websites\": [\n {}\n ],\n \"vertical\": \"<string>\",\n \"profilePictureUrl\": \"<string>\"\n}")
.asString();{
"gmb": {
"status": "success",
"data": {
"name": "locations/4913369732395328466",
"languageCode": "en",
"title": "Ayrshare",
"phoneNumbers": {},
"categories": {
"primaryCategory": {
"name": "categories/gcid:software_company",
"displayName": "Software company",
"serviceTypes": [
{
"serviceTypeId": "job_type_id:application_development",
"displayName": "Application development"
},
{
"serviceTypeId": "job_type_id:big_data_consulting_and_implementation",
"displayName": "Big data consulting & implementation"
},
{
"serviceTypeId": "job_type_id:data_center_management",
"displayName": "Data center management"
},
{
"serviceTypeId": "job_type_id:data_quality_management",
"displayName": "Data quality management"
},
{
"serviceTypeId": "job_type_id:enterprise_software_development",
"displayName": "Enterprise software development"
},
{
"serviceTypeId": "job_type_id:it_consulting",
"displayName": "It consulting"
},
{
"serviceTypeId": "job_type_id:mobile_app_development",
"displayName": "Mobile app development"
},
{
"serviceTypeId": "job_type_id:platform_consulting",
"displayName": "Platform consulting"
},
{
"serviceTypeId": "job_type_id:security_services_management",
"displayName": "Security services management"
},
{
"serviceTypeId": "job_type_id:software_consulting",
"displayName": "Software consulting"
},
{
"serviceTypeId": "job_type_id:software_development",
"displayName": "Software development"
},
{
"serviceTypeId": "job_type_id:software_development_outsourcing",
"displayName": "Software development outsourcing"
},
{
"serviceTypeId": "job_type_id:solution_consulting",
"displayName": "Solution consulting"
}
],
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
},
"additionalCategories": [
{
"name": "categories/gcid:automation_company",
"displayName": "Automation company",
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
}
]
},
"storefrontAddress": {
"regionCode": "US",
"languageCode": "en",
"postalCode": "10019",
"administrativeArea": "NY",
"locality": "New York",
"addressLines": [
"142 W 57th St"
]
},
"websiteUri": "https://www.ayrshare.com/",
"regularHours": {
"periods": [
{
"openDay": "SUNDAY",
"openTime": {},
"closeDay": "SUNDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "MONDAY",
"openTime": {},
"closeDay": "MONDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "TUESDAY",
"openTime": {},
"closeDay": "TUESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "WEDNESDAY",
"openTime": {},
"closeDay": "WEDNESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "THURSDAY",
"openTime": {},
"closeDay": "THURSDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "FRIDAY",
"openTime": {},
"closeDay": "FRIDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "SATURDAY",
"openTime": {},
"closeDay": "SATURDAY",
"closeTime": {
"hours": 24
}
}
]
},
"serviceArea": {
"businessType": "CUSTOMER_AND_BUSINESS_LOCATION",
"places": {
"placeInfos": [
{
"placeName": "United States",
"placeId": "ChIJCzYy5IS16lQRQrfeQ5K5Oxw"
}
]
},
"regionCode": "US"
},
"openInfo": {
"status": "OPEN",
"canReopen": true
},
"metadata": {
"hasPendingEdits": true,
"canDelete": true,
"canModifyServiceList": true,
"placeId": "ChIJN53jw8BZwokRBEeVVtPLkkg",
"mapsUri": "https://maps.google.com/maps?cid=5229466225881728772",
"newReviewUri": "https://search.google.com/local/writereview?placeid=ChIJN53jw8BZwokRBEeVVtPLkkg",
"hasVoiceOfMerchant": true
},
"profile": {
"description": "Easy to integrate Social Media APIs allow you to manage all your users' social accounts right from your product. Post, Auto Schedule, and Analytics. Great for SaaS, CMS, DAM, Agencies, and Apps."
}
}
}
}
{
"action": "authorization",
"status": "error",
"code": 227,
"message": "Error updating GBP location data. This can occur if you attempt more than 5 updates within a rolling 24 hours period. Please wait and try again."
}
{
"whatsapp": {
"status": "success",
"data": {
"messaging_product": "whatsapp",
"about": "Open 9am-6pm",
"description": "Bike shop since 1998",
"address": "123 Example St, Springfield",
"email": "hello@example.com",
"websites": ["https://example.com"],
"vertical": "RETAIL",
"profile_picture_url": "https://scontent.whatsapp.net/..."
}
}
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "`about` must be 139 characters or fewer (received 150)."
}
{
"action": "post",
"status": "error",
"code": 156,
"message": "whatsapp is not linked. Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/dashboard/connect-social-accounts/overview"
}
{
"action": "request",
"status": "error",
"code": 472,
"message": "This feature is not yet available on your account. Please contact us if you'd like early access."
}
{
"action": "rate limit",
"status": "error",
"code": 364,
"message": "You are making too many requests. Please reduce the number of requests.",
"details": "Meta rejected the WhatsApp profile request."
}
{
"action": "authorization",
"status": "error",
"code": 141,
"message": "There was an issue connecting. Please try linking the social account again.",
"details": "Network error updating the WhatsApp business profile."
}
更新社群網路的帳號或使用者資料。目前支援 Google Business Profile 和 WhatsApp。
WhatsApp
只需傳送你想變更的欄位。至少需要一個欄位,且傳送此端點無法辨識的欄位會導致整個請求被拒絕。
若要清除某個欄位,請將其以空字串傳送:
Google 限制某些 Google Business Profile 地點欄位在 24 小時滾動期間內最多只能更新 5 次。例如,若
phoneNumbers 在 24 小時滾動期間內更新超過 5 次,將會回傳 400 錯誤。此限制僅適用於 Google Business Profile,不適用於 WhatsApp。標頭參數
路徑參數
string
必填
值:
gbp、whatsappBody 參數
object
包含客戶可用來聯繫商家的各種電話號碼的物件。
"phoneNumbers": {
"primaryPhone": "212-123-4567",
"additionalPhones": [
"212-432-2342"
]
}
string
此地點的 Google 識別碼。
string
用於 AdWords 地點擴充功能顯示的替代電話號碼,取代該地點的主要電話號碼。
string
此地點的外部識別碼,在指定的帳號中必須唯一。用於將該地點與你自己的紀錄關聯起來。
string
地點名稱應反映商家在真實世界中的名稱,並與店面、網站、文具用品上一致,也是客戶所熟知的名稱。
string
此商家的 URL。
array
一組自由格式的字串,可用來為你的商家加上標籤。這些標籤不對外顯示,僅你自己看得見。每個標籤必須介於 1-255 字元。
object
代表一組經緯度的物件。以一對雙精度浮點數表示緯度與經度(單位為度)。除非另有說明,此物件必須遵循 WGS84 標準。數值必須位於標準化範圍內。緯度(度),必須介於 [-90.0, +90.0]。經度(度),必須介於 [-180.0, +180.0]。
{
"latitude": number,
"longitude": number
}
object
此欄位包含以你自己口吻撰寫的地點描述,其他人無法編輯。
{
"description": string
}
WhatsApp 處於 Private Beta 階段。 更新 WhatsApp 商家檔案需要已核准使用 WhatsApp
的帳號。若你想搶先取得使用權限,請寄信至
lotty@ayrshare.com。
{"description": ""} 會移除描述,該欄位之後就完全不會再出現在商家檔案中。此做法適用於 description、address 與 email。但不適用於 about,因為 WhatsApp 要求它至少要有一個字元——若要變更它,請直接覆寫。vertical 一旦設定後也無法清除。
回應欄位 messaging_product 與 profile_picture_url(請參閱 WhatsApp 商家檔案)為唯讀:傳回其中任一者都會被視為無法辨識的欄位而拒絕。請使用 profilePictureUrl 設定相片。
string
顯示在商家檔案圖片下方的文字。1-139 字元。這是唯一一個 WhatsApp 不允許清除的文字欄位——請改以覆寫方式變更。
string
商家描述。最多 512 字元。傳送
"" 可清除。string
商家地址。最多 256 字元。傳送
"" 可清除。string
聯絡用電子郵件地址。最多 128 字元,且除非你是傳送
"" 來清除它,否則必須是有效的地址。array
一個非空陣列,最多 2 個 URL,每個都必須以
http:// 或 https:// 開頭。string
商家類別。WhatsApp 目前接受:
OTHER、AUTO、BEAUTY、APPAREL、
EDU、ENTERTAIN、EVENT_PLAN、FINANCE、GROCERY、GOVT、HOTEL、HEALTH、
NONPROFIT、PROF_SERVICES、RETAIL、TRAVEL、RESTAURANT、ALCOHOL、
ONLINE_GAMBLING、PHYSICAL_GAMBLING、OTC_DRUGS、MATRIMONY_SERVICE。此清單由 WhatsApp 制定,且可能隨時間增加——Ayrshare 不會限制此值,因此任何 WhatsApp 接受的類別都可使用。值會被正規化為大寫,因此以 retail 傳送的值會以 RETAIL 回傳。WhatsApp 不允許在類別設定後再清除它,並會拒絕它不接受的值——該拒絕會以 101 回傳,並附上 WhatsApp 自身的訊息,列出目前接受的值。string
可公開存取的 JPEG 或 PNG,5 MB 或更小。圖片必須為正方形且至少 192×192——建議使用 640×640。沒有最大解析度限制:較大的圖片會被接受並由 WhatsApp 縮小。不是正方形或低於 192×192 的圖片,會在任何內容送至 WhatsApp 之前,以指出問題的
400 拒絕。完整需求請參閱 WhatsApp 媒體規範。{
"gmb": {
"status": "success",
"data": {
"name": "locations/4913369732395328466",
"languageCode": "en",
"title": "Ayrshare",
"phoneNumbers": {},
"categories": {
"primaryCategory": {
"name": "categories/gcid:software_company",
"displayName": "Software company",
"serviceTypes": [
{
"serviceTypeId": "job_type_id:application_development",
"displayName": "Application development"
},
{
"serviceTypeId": "job_type_id:big_data_consulting_and_implementation",
"displayName": "Big data consulting & implementation"
},
{
"serviceTypeId": "job_type_id:data_center_management",
"displayName": "Data center management"
},
{
"serviceTypeId": "job_type_id:data_quality_management",
"displayName": "Data quality management"
},
{
"serviceTypeId": "job_type_id:enterprise_software_development",
"displayName": "Enterprise software development"
},
{
"serviceTypeId": "job_type_id:it_consulting",
"displayName": "It consulting"
},
{
"serviceTypeId": "job_type_id:mobile_app_development",
"displayName": "Mobile app development"
},
{
"serviceTypeId": "job_type_id:platform_consulting",
"displayName": "Platform consulting"
},
{
"serviceTypeId": "job_type_id:security_services_management",
"displayName": "Security services management"
},
{
"serviceTypeId": "job_type_id:software_consulting",
"displayName": "Software consulting"
},
{
"serviceTypeId": "job_type_id:software_development",
"displayName": "Software development"
},
{
"serviceTypeId": "job_type_id:software_development_outsourcing",
"displayName": "Software development outsourcing"
},
{
"serviceTypeId": "job_type_id:solution_consulting",
"displayName": "Solution consulting"
}
],
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
},
"additionalCategories": [
{
"name": "categories/gcid:automation_company",
"displayName": "Automation company",
"moreHoursTypes": [
{
"hoursTypeId": "ACCESS",
"displayName": "Access",
"localizedDisplayName": "Access"
},
{
"hoursTypeId": "BREAKFAST",
"displayName": "Breakfast",
"localizedDisplayName": "Breakfast"
},
{
"hoursTypeId": "BRUNCH",
"displayName": "Brunch",
"localizedDisplayName": "Brunch"
},
{
"hoursTypeId": "DELIVERY",
"displayName": "Delivery",
"localizedDisplayName": "Delivery"
},
{
"hoursTypeId": "DINNER",
"displayName": "Dinner",
"localizedDisplayName": "Dinner"
},
{
"hoursTypeId": "DRIVE_THROUGH",
"displayName": "Drive through",
"localizedDisplayName": "Drive through"
},
{
"hoursTypeId": "HAPPY_HOUR",
"displayName": "Happy hours",
"localizedDisplayName": "Happy hours"
},
{
"hoursTypeId": "KITCHEN",
"displayName": "Kitchen",
"localizedDisplayName": "Kitchen"
},
{
"hoursTypeId": "LUNCH",
"displayName": "Lunch",
"localizedDisplayName": "Lunch"
},
{
"hoursTypeId": "ONLINE_SERVICE_HOURS",
"displayName": "Online service hours",
"localizedDisplayName": "Online service hours"
},
{
"hoursTypeId": "PICKUP",
"displayName": "Pickup",
"localizedDisplayName": "Pickup"
},
{
"hoursTypeId": "TAKEOUT",
"displayName": "Takeout",
"localizedDisplayName": "Takeout"
},
{
"hoursTypeId": "SENIOR_HOURS",
"displayName": "Senior hours",
"localizedDisplayName": "Senior hours"
}
]
}
]
},
"storefrontAddress": {
"regionCode": "US",
"languageCode": "en",
"postalCode": "10019",
"administrativeArea": "NY",
"locality": "New York",
"addressLines": [
"142 W 57th St"
]
},
"websiteUri": "https://www.ayrshare.com/",
"regularHours": {
"periods": [
{
"openDay": "SUNDAY",
"openTime": {},
"closeDay": "SUNDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "MONDAY",
"openTime": {},
"closeDay": "MONDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "TUESDAY",
"openTime": {},
"closeDay": "TUESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "WEDNESDAY",
"openTime": {},
"closeDay": "WEDNESDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "THURSDAY",
"openTime": {},
"closeDay": "THURSDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "FRIDAY",
"openTime": {},
"closeDay": "FRIDAY",
"closeTime": {
"hours": 24
}
},
{
"openDay": "SATURDAY",
"openTime": {},
"closeDay": "SATURDAY",
"closeTime": {
"hours": 24
}
}
]
},
"serviceArea": {
"businessType": "CUSTOMER_AND_BUSINESS_LOCATION",
"places": {
"placeInfos": [
{
"placeName": "United States",
"placeId": "ChIJCzYy5IS16lQRQrfeQ5K5Oxw"
}
]
},
"regionCode": "US"
},
"openInfo": {
"status": "OPEN",
"canReopen": true
},
"metadata": {
"hasPendingEdits": true,
"canDelete": true,
"canModifyServiceList": true,
"placeId": "ChIJN53jw8BZwokRBEeVVtPLkkg",
"mapsUri": "https://maps.google.com/maps?cid=5229466225881728772",
"newReviewUri": "https://search.google.com/local/writereview?placeid=ChIJN53jw8BZwokRBEeVVtPLkkg",
"hasVoiceOfMerchant": true
},
"profile": {
"description": "Easy to integrate Social Media APIs allow you to manage all your users' social accounts right from your product. Post, Auto Schedule, and Analytics. Great for SaaS, CMS, DAM, Agencies, and Apps."
}
}
}
}
{
"action": "authorization",
"status": "error",
"code": 227,
"message": "Error updating GBP location data. This can occur if you attempt more than 5 updates within a rolling 24 hours period. Please wait and try again."
}
{
"whatsapp": {
"status": "success",
"data": {
"messaging_product": "whatsapp",
"about": "Open 9am-6pm",
"description": "Bike shop since 1998",
"address": "123 Example St, Springfield",
"email": "hello@example.com",
"websites": ["https://example.com"],
"vertical": "RETAIL",
"profile_picture_url": "https://scontent.whatsapp.net/..."
}
}
}
{
"action": "request",
"status": "error",
"code": 101,
"message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis",
"details": "`about` must be 139 characters or fewer (received 150)."
}
{
"action": "post",
"status": "error",
"code": 156,
"message": "whatsapp is not linked. Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/dashboard/connect-social-accounts/overview"
}
{
"action": "request",
"status": "error",
"code": 472,
"message": "This feature is not yet available on your account. Please contact us if you'd like early access."
}
{
"action": "rate limit",
"status": "error",
"code": 364,
"message": "You are making too many requests. Please reduce the number of requests.",
"details": "Meta rejected the WhatsApp profile request."
}
{
"action": "authorization",
"status": "error",
"code": 141,
"message": "There was an issue connecting. Please try linking the social account again.",
"details": "Network error updating the WhatsApp business profile."
}