> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新用户

> 更新社交网络的账户或用户数据

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

更新社交网络的账户或用户数据。目前仅支持 Google Business Profile。

<Note>Google 对某些 Google Business Profile 位置字段的更新频率有限制,滚动 24 小时窗口内最多可更新 5 次。例如,在滚动 24 小时内对 `phoneNumbers` 更新超过 5 次将返回 400 响应。</Note>

## Header 参数

<HeaderAPI />

## Path 参数

<ParamField path=":platform" type="string" required>
  取值:`gbp`
</ParamField>

## Body 参数

<ParamField body="phoneNumbers" type="object">
  一个对象,包含客户可用来联系该商家的不同电话号码。

  ```json theme={"system"}
  "phoneNumbers": {
      "primaryPhone": "212-123-4567",
      "additionalPhones": [
          "212-432-2342"
      ]
  }
  ```
</ParamField>

<ParamField body="name" type="string">
  Google 为该位置分配的标识符。
</ParamField>

<ParamField body="adPhone" type="string">
  一个用于在 AdWords 位置扩展中显示的备用电话号码,替代该位置的主电话。
</ParamField>

<ParamField body="storeCode" type="string">
  该位置的外部标识符,在给定账户内必须唯一。可用于将该位置与你自己的记录进行关联。
</ParamField>

<ParamField body="title" type="string">
  位置名称应反映商家在现实世界中的实际名称,并与门店招牌、网站、办公用品以及客户所熟知的名称保持一致。
</ParamField>

<ParamField body="websiteUrl" type="string">
  该商家的网站 URL。
</ParamField>

<ParamField body="labels" type="array">
  用于为你的商家打标签的自由格式字符串集合。这些标签不会对用户展示;仅你可见。每个标签必须在 1-255 个字符之间。
</ParamField>

<ParamField body="latlng" type="object">
  表示经纬度对的对象。以两个 double 表示,分别代表纬度和经度。除非另有说明,该对象必须符合 WGS84 标准。

  ```json theme={"system"}
  {
      "latitude": number,
      "longitude": number
  }
  ```

  数值必须在规范化范围内。

  纬度,以度为单位。范围必须为 \[-90.0, +90.0]。

  经度,以度为单位。范围必须为 \[-180.0, +180.0]。
</ParamField>

<ParamField body="profile" type="object">
  此字段包含商家用自己语言撰写的位置描述。该描述其他人无法编辑。

  ```json theme={"system"}
  {
      "description": string
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200: Success theme={"system"}
  {
      "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."
              }
          }
      }
  }
  ```

  ```json 400: Too Many Updates theme={"system"}
  {
      "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."
  }
  ```
</ResponseExample>
