Создание элементаPublication

Статья
06/11/2024

Пространство имен: microsoft.graph

Создайте объект itemPublication в профиле пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	User.ReadWrite	User.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	User.ReadWrite	Недоступно.
Для приложений	Не поддерживается.	Не поддерживается.

HTTP-запрос

POST /me/profile/publications
POST /users/{id | userPrincipalName}/profile/publications

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта itemPublication в формате JSON.

В следующей таблице показаны свойства, которые можно задать при создании объекта itemPublication в профиле пользователя.

Свойство	Тип	Описание
allowedAudiences	String	Аудитории, которые могут видеть значения, содержащиеся в сущности. Наследуется от itemFacet. Возможные значения: `me`, `family`, `contacts`, `groupMembers`, `organization`, `federatedOrganizations`, `everyone`, `unknownFutureValue`.
createdBy	identitySet	Предоставляет идентификатор пользователя и (или) приложения, создавшего сущность. Наследуется от itemFacet.
createdDateTime	DateTimeOffset	Предоставляет параметр dateTimeOffset для момента создания сущности. Наследуется от itemFacet.
description	String	Описание публикации.
displayName	String	Название публикации.
id	String	Идентификатор, используемый для адресации сущности по отдельности. Наследуется от сущности
Вывод	inferenceData	Содержит сведения о выводе, если сущность выводится путем создания или изменения приложения. Наследуется от itemFacet.
lastModifiedBy	identitySet	Предоставляет идентификатор пользователя и (или) приложения, которые в последний раз изменяли сущность. Наследуется от itemFacet.
lastModifiedDateTime	DateTimeOffset	Предоставляет параметр dateTimeOffset для момента создания сущности. Наследуется от itemFacet.
дата публикации	Date	Дата публикации.
publisher	String	Публикация или издатель публикации.
source	personDataSource	Место, откуда берутся значения, если синхронизированы из другой службы. Наследуется от itemFacet.
thumbnailUrl	String	URL-адрес, ссылающийся на эскиз публикации.
webUrl	String	URL-адрес, ссылающийся на публикацию.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 201 Created и объект itemPublication в тексте ответа.

Примеры

POST https://graph.microsoft.com/beta/me/profile/publications
Content-Type: application/json

{
  "description": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new ItemPublication
{
	Description = "One persons journey to the top of the branding management field.",
	DisplayName = "Got Brands? The story of Innocenty Popov and his journey to the top.",
	PublishedDate = new Date(DateTime.Parse("Date")),
	Publisher = "International Association of Branding Management Publishing",
	ThumbnailUrl = "https://iabm.io/sdhdfhsdhshsd.jpg",
	WebUrl = "https://www.iabm.io",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Profile.Publications.PostAsync(requestBody);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



mgc-beta users profile publications create --user-id {user-id} --body '{\
  "description": "One persons journey to the top of the branding management field.",\
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",\
  "publishedDate": "Date",\
  "publisher": "International Association of Branding Management Publishing",\
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",\
  "webUrl": "https://www.iabm.io"\
}\
'

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewItemPublication()
description := "One persons journey to the top of the branding management field."
requestBody.SetDescription(&description) 
displayName := "Got Brands? The story of Innocenty Popov and his journey to the top."
requestBody.SetDisplayName(&displayName) 
publishedDate := date
requestBody.SetPublishedDate(&publishedDate) 
publisher := "International Association of Branding Management Publishing"
requestBody.SetPublisher(&publisher) 
thumbnailUrl := "https://iabm.io/sdhdfhsdhshsd.jpg"
requestBody.SetThumbnailUrl(&thumbnailUrl) 
webUrl := "https://www.iabm.io"
requestBody.SetWebUrl(&webUrl) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
publications, err := graphClient.Me().Profile().Publications().Post(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ItemPublication itemPublication = new ItemPublication();
itemPublication.setDescription("One persons journey to the top of the branding management field.");
itemPublication.setDisplayName("Got Brands? The story of Innocenty Popov and his journey to the top.");
LocalDate publishedDate = LocalDate.parse("Date");
itemPublication.setPublishedDate(publishedDate);
itemPublication.setPublisher("International Association of Branding Management Publishing");
itemPublication.setThumbnailUrl("https://iabm.io/sdhdfhsdhshsd.jpg");
itemPublication.setWebUrl("https://www.iabm.io");
ItemPublication result = graphClient.me().profile().publications().post(itemPublication);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const itemPublication = {
  description: 'One persons journey to the top of the branding management field.',
  displayName: 'Got Brands? The story of Innocenty Popov and his journey to the top.',
  publishedDate: 'Date',
  publisher: 'International Association of Branding Management Publishing',
  thumbnailUrl: 'https://iabm.io/sdhdfhsdhshsd.jpg',
  webUrl: 'https://www.iabm.io'
};

await client.api('/me/profile/publications')
	.version('beta')
	.post(itemPublication);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\ItemPublication;
use Microsoft\Kiota\Abstractions\Types\Date;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ItemPublication();
$requestBody->setDescription('One persons journey to the top of the branding management field.');
$requestBody->setDisplayName('Got Brands? The story of Innocenty Popov and his journey to the top.');
$requestBody->setPublishedDate(new Date('Date'));
$requestBody->setPublisher('International Association of Branding Management Publishing');
$requestBody->setThumbnailUrl('https://iabm.io/sdhdfhsdhshsd.jpg');
$requestBody->setWebUrl('https://www.iabm.io');

$result = $graphServiceClient->me()->profile()->publications()->post($requestBody)->wait();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


Import-Module Microsoft.Graph.Beta.People

$params = @{
	description = "One persons journey to the top of the branding management field."
	displayName = "Got Brands? The story of Innocenty Popov and his journey to the top."
	publishedDate = "Date"
	publisher = "International Association of Branding Management Publishing"
	thumbnailUrl = "https://iabm.io/sdhdfhsdhshsd.jpg"
	webUrl = "https://www.iabm.io"
}

# A UPN can also be used as -UserId.
New-MgBetaUserProfilePublication -UserId $userId -BodyParameter $params

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.item_publication import ItemPublication
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ItemPublication(
	description = "One persons journey to the top of the branding management field.",
	display_name = "Got Brands? The story of Innocenty Popov and his journey to the top.",
	published_date = "Date",
	publisher = "International Association of Branding Management Publishing",
	thumbnail_url = "https://iabm.io/sdhdfhsdhshsd.jpg",
	web_url = "https://www.iabm.io",
)

result = await graph_client.me.profile.publications.post(request_body)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
  "allowedAudiences": "organization",
  "inference": null,
  "createdDateTime": "2020-07-06T06:34:12.2294868Z",
  "createdBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
  "lastModifiedBy": {
    "application": null,
    "device": null,
    "user": {
      "displayName": "Innocenty Popov",
      "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
    }
  },
  "source": null,
  "description": "One persons journey to the top of the branding management field.",
  "displayName": "Got Brands? The story of Innocenty Popov and his journey to the top.",
  "publishedDate": "Date",
  "publisher": "International Association of Branding Management Publishing",
  "thumbnailUrl": "https://iabm.io/sdhdfhsdhshsd.jpg",
  "webUrl": "https://www.iabm.io"
}

Поделиться через

Создание элементаPublication

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Отклик

Обратная связь

Дополнительные ресурсы